Класс I18n
I18n обрабатывает перевод текстовых строк и форматов времени.
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: 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 )
Связывает заданную область с файлом в указанной директории.
Параметры
- строка
$domain - Связываемая область
Возвращаемое значение
строкаСвязанная область
_parseLiteralValue()source protected
_parseLiteralValue( string $string )
Вспомогательная функция для разбора символа из файла определения локали
Параметры
- строка
$string - Разбираемый символ
Возвращаемое значение
строкаРазбираемый символ
_pluralGuess()source protected
_pluralGuess( string $header , integer $n )
Попытка найти форму множественного числа строки.
Параметры
- строка
$header - Тип
- целое число
$n - Число
Возвращаемое значение
целое числоСоответствие множественного числа
Ссылка
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 )
Возвращает определение формата времени из соответствующей области
Параметры
- строка
$format - Формат для перевода
- строка
$domain - Область, в которой хранится формат
Возвращаемое значение
смешанный типпереведённая строка формата, если это значение, или массив переведённых строк для соответствующего формата.
clear()source public static
clear( )
Очищает внутренний массив данных областей. Полезно для тестирования i18n.
domains()source public static
domains( )
Получить кэш загруженных областей.
Возвращаемое значение
массив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 Возвращает переведенную строку на основе текущего языка и файлов переводов, хранящихся в папке locale
Параметры
- 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–2016 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.9/class-I18n.html