Spec-Zone.ru › CakePHP 2.9

Класс I18n

I18n обрабатывает перевод текстовых строк и форматов времени.

Пакет: Cake\I18n
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/I18n/I18n.php

Краткое описание констант

  • integer

    LC_ALL
    0
  • integer

    LC_COLLATE
    1
  • integer

    LC_CTYPE
    2
  • integer

    LC_MESSAGES
    6
  • integer

    LC_MONETARY
    3
  • integer

    LC_NUMERIC
    4
  • integer

    LC_TIME
    5

Краткое описание свойств

  • $_categories protected
    array
    Категории перевода
  • $_domains protected
    array
    Строки перевода для определённой области, считываемые из файлов .mo или .po
  • $_escape protected
    string
    Строка экранирования
  • $_lang protected
    string
    Текущий язык, используемый для перевода
  • $_noLocale protected
    boolean

    Устанавливается в значение true при первом вызове I18N::_bindTextDomain(). Если найден файл перевода, устанавливается обратно в false.

  • $category public
    string
    Текущая категория перевода
  • $defaultDomain public static
    string
    По умолчанию, область перевода
  • $domain public
    string
    Текущая область перевода
  • $l10n public
    L10n
    Экземпляр класса L10n для локализации

Краткое описание методов

  • __construct() public
    Конструктор, используйте I18n::getInstance() для получения объекта перевода i18n.
  • _bindTextDomain() protected
    Связывает заданную область с файлом в указанной директории.
  • _parseLiteralValue() protected
    Вспомогательная функция для разбора символа из файла определения локали
  • _pluralGuess() protected
    Попытка найти форму множественного числа строки.
  • _translateTime() protected
    Возвращает определение формата времени из соответствующей области
  • clear() public static
    Очищает внутренний массив данных областей. Полезно для тестирования i18n.
  • domains() public static
    Получить кэш загруженных областей.
  • getInstance() public static
    Возвращает статический экземпляр класса I18n
  • insertArgs() public static
    Вставляет параметры в исходные переведённые строки
  • loadLocaleDefinition() public static
    Парсит файл определения локали, следуя стандарту POSIX
  • loadMo() public static
    Загружает бинарный файл .mo и возвращает массив переводов
  • loadPo() public static
    Загружает текстовый файл .po и возвращает массив переводов
  • translate() public static

    Используется функциями перевода в 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.html
https://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

Возвращаемое значение

I18n
END_OF_DOCUMENT_MARKER

insertArgs()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.html

loadPo()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()

$_escapesource

protected string

Строка экранирования

null

$_langsource

protected string

Текущий язык, используемый для переводов

null

$_noLocalesource

protected boolean

Устанавливается в true при первом вызове I18N::_bindTextDomain(). Если файл перевода найден, он снова устанавливается в false

false

$categorysource

public string

Текущая категория перевода

'LC_MESSAGES'

$defaultDomainsource

public static string

Домен перевода по умолчанию

'default'

$domainsource

public string

Текущий домен перевода

null

$l10nsource

public L10n

Экземпляр класса L10n для локализации

null

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API