Класс I18n
I18n обрабатывает перевод текстовых и строковых форматов времени.
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT Лицензия
Расположение: Cake/I18n/I18n.php
Краткое описание констант
-
integer0 -
integer1 -
integer2 -
integer6 -
integer3 -
integer4 -
integer5
Краткое описание свойств
-
$_categoriesprotectedКатегории переводовarray -
$_domainsprotectedСтроки перевода для определенного домена, считываемые из файлов .mo или .poarray -
$_escapeprotectedСтрока экранированияstring -
$_langprotectedТекущий язык, используемый для переводовstring -
$_noLocaleprotectedbooleanУстанавливается в true при первом вызове I18N::_bindTextDomain(). Если файл перевода найден, он устанавливается обратно в false.
-
$categorypublicТекущая категория переводаstring - По умолчанию домен перевода
string -
$domainpublicТекущий домен переводаstring - Экземпляр класса L10n для локализации
$l10npublic
Краткое описание методов
- __construct() publicКонструктор, используйте I18n::getInstance() для получения объекта перевода i18n.
- _bindTextDomain() protectedСвязывает указанный домен с файлом в указанной директории.
- _parseLiteralValue() protectedВспомогательная функция для разбора символа из файла определения локали
- _pluralGuess() protectedПопытка найти форму множественного числа строки.
- _translateTime() protectedВозвращает определение формата времени из соответствующего домена
- Очищает внутренний массив данных доменов. Полезно для тестирования i18n.
- Получить кэш загруженных доменов.
- Возвращает статический экземпляр класса I18n
- Вставляет параметры в исходные переведенные строки
- Разбирает файл определения локали, следуя стандарту POSIX
- Загружает двоичный файл .mo и возвращает массив переводов
- Загружает текстовый файл .po и возвращает массив переводов
-
Используется функциями перевода в basics.php. Возвращает переведенную строку на основе текущего языка и файлов переводов, хранящихся в папке locale
Подробное описание методов
__construct()source public
__construct( )
Конструктор, используйте I18n::getInstance() для получения объекта перевода i18n.
_bindTextDomain()source protected
_bindTextDomain( string $domain )
Связывает указанный домен с файлом в указанной директории.
Параметры
- string
$domain - Домен для связывания
Возвращает
stringПривязанный домен
_parseLiteralValue()source protected
_parseLiteralValue( string $string )
Вспомогательная функция для разбора символа из файла определения локали
Параметры
- string
$string - Символ для разбора
Возвращает
stringРазбор символа
_pluralGuess()source protected
_pluralGuess( string $header , integer $n )
Попытка найти форму множественного числа строки.
Параметры
- string
$header - Тип
- integer
$n - Число
Возвращает
integerСовпадение формы множественного числа
Ссылка
http://localization-guide.readthedocs.org/en/latest/l10n/pluralforms.htmlhttps://developer.mozilla.org/en-US/docs/Mozilla/Localization/Localization_and_Plurals#List_of_Plural_Rules
_translateTime()source protected
_translateTime( string $format , string $domain )
Возвращает определение формата времени из соответствующего домена
Параметры
- string
$format - Формат для перевода
- string
$domain - Домен, где хранится формат
Возвращает
mixedПереведенная строка формата, если это только значение, или массив переведенных строк для соответствующего формата.
clear()source public static
clear( )
Очищает внутренний массив данных доменов. Полезно для тестирования i18n.
getInstance()source public static
getInstance( )
Возвращает статический экземпляр класса I18n
Возвращает
I18ninsertArgs()source public static
insertArgs( string $translated , array $args )
Подставляет параметры в исходные переведенные строки
Параметры
- string
$translated - Исходная переведенная строка
- array
$args - Аргументы для подстановки в перевод
Возвращает
stringПереведенная строка с аргументами
loadLocaleDefinition()source public static
loadLocaleDefinition( string $filename )
Парсит файл определения локали, следуя стандарту POSIX
Параметры
- string
$filename - Имя файла определения локали
Возвращает
mixedМассив определений при успехе или false при ошибке
loadMo()source public static
loadMo( string $filename )
Загружает двоичный файл .mo и возвращает массив переводов
Параметры
- string
$filename - Двоичный файл .mo для загрузки
Возвращает
mixedМассив переводов при успехе или false при ошибке
Ссылка
https://www.gnu.org/software/gettext/manual/html_node/MO-Files.htmlloadPo()source public static
loadPo( string $filename )
Загружает текстовый файл .po и возвращает массив переводов
Параметры
- string
$filename - Текстовый файл .po для загрузки
Возвращает
mixedМассив переводов при успехе или false при ошибке
translate()source public static
translate( string $singular , string $plural null , string $domain null , string $category self::LC_MESSAGES , integer $count null , string $language null , string $context null )
Используется функциями перевода в basics.php. Возвращает переведенную строку на основе текущего языка и файлов переводов, хранящихся в папке локали
Параметры
- string
$singular - Строка для перевода
- string
$pluralнеобязательно null - Строка множественного числа (если есть)
- string
$domainнеобязательно null Домен Домен перевода. Домены часто используются при переводах плагинов. Если null, используется стандартный домен.
- string
$categoryнеобязательно self::LC_MESSAGES - Категория Целочисленное значение категории для использования.
- integer
$countнеобязательно null - Счетчик Счетчик используется с $plural для выбора правильной формы множественного числа.
- string
$languageнеобязательно null Язык для перевода строки. Если null, проверяется язык в сессии, а затем переменная конфигурации Config.language.
- string
$contextнеобязательно null - Контекст Контекст перевода, например, глагол или существительное.
Возвращает
stringПереведенная строка.
Исключение
CakeExceptionКогда '' используется в качестве домена.
Подробное описание свойств
$_categoriessource
protected array
Категории перевода
array(
'LC_ALL', 'LC_COLLATE', 'LC_CTYPE', 'LC_MONETARY', 'LC_NUMERIC', 'LC_TIME', 'LC_MESSAGES'
) $_domainssource
protected array
Строки перевода для определенного домена, считанные из файлов .mo или .po
array()
$_noLocalesource
protected boolean
Устанавливается в true, когда I18N::_bindTextDomain() вызывается в первый раз. Если файл перевода найден, он снова устанавливается в false
false
© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.10/class-I18n.html