Класс I18n
I18n обрабатывает перевод строк текста и форматов времени.
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://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 )
Привязывает заданный домен к файлу в указанной директории.
Параметры
- строка
$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 )
Подставляет параметры в обычные переведённые строки
Параметры
- строка
$translated - Исходная переведённая строка
- массив
$args - Аргументы для подстановки в перевод
Возвращает
строкаПереведённая строка с аргументами
loadLocaleDefinition()source public static
loadLocaleDefinition( string $filename )
Парсит файл определения локали, следуя стандарту POSIX
Параметры
- строка
$filename - Имя файла определения локали
Возвращает
смешанный типМассив определений при успехе или false при ошибке
loadMo()source public static
loadMo( string $filename )
Загружает двоичный файл .mo и возвращает массив переводов
Параметры
- строка
$filename - Двоичный файл .mo для загрузки
Возвращает
смешанный типМассив переводов при успехе или false при ошибке
Ссылка
https://www.gnu.org/software/gettext/manual/html_node/MO-Files.htmlloadPo()source public static
loadPo( string $filename )
Загружает текстовый файл .po и возвращает массив переводов
Параметры
- строка
$filename - Текстовый файл .po для загрузки
Возвращает
смешанный типМассив переводов при успехе или 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
Параметры
- строка
$singular - Строка для перевода
- строка
$pluralнеобязательно null - Строка множественного числа (если есть)
- строка
$domainнеобязательно null Домен Домен перевода. Домены часто используются для переводов плагинов. Если null, будет использован домен по умолчанию.
- строка
$categoryнеобязательно self::LC_MESSAGES - Категория Целочисленное значение категории для использования.
- целое число
$countнеобязательно null - Счётчик Счётчик используется с $plural для выбора правильной формы множественного числа.
- строка
$languageнеобязательно null Язык для перевода строки. Если null, ищет язык в сессии, а затем в переменной конфигурации Config.language.
- строка
$contextнеобязательно null - Контекст Контекст перевода, например, глагол или существительное.
Возвращает
строкапереведённая строка.
Выбрасывает
CakeExceptionКогда '' указан в качестве домена.
Подробное описание свойств
$_categoriessource
protected массив
Категории перевода
array(
'LC_ALL', 'LC_COLLATE', 'LC_CTYPE', 'LC_MONETARY', 'LC_NUMERIC', 'LC_TIME', 'LC_MESSAGES'
) $_domainssource
protected массив
Строки перевода для определённого домена, считанные из файлов .mo или .po
array()
$_noLocalesource
protected логическое значение
Устанавливается в 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.
http://api.cakephp.org/2.8/class-I18n.html