Spec-Zone.ru › CakePHP 2.10

Класс I18n

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

Пакет: Cake\I18n
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT Лицензия
Расположение: 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 )

Связывает указанный домен с файлом в указанной директории.

Параметры

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.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 )

Возвращает определение формата времени из соответствующего домена

Параметры

string $format
Формат для перевода
string $domain
Домен, где хранится формат

Возвращает

mixed
Переведенная строка формата, если это только значение, или массив переведенных строк для соответствующего формата.

clear()source public static

clear( )

Очищает внутренний массив данных доменов. Полезно для тестирования i18n.

domains()source public static

domains( )

Получить кэш загруженных доменов.

Возвращает

array

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. Возвращает переведенную строку на основе текущего языка и файлов переводов, хранящихся в папке локали

Параметры

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–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

Spec-Zone.ru

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