Class I18n

__constructsource public

__construct( )

Constructor, use I18n::getInstance() to get the i18n translation object.

_bindTextDomainsource protected

_bindTextDomain( string $domain )

Binds the given domain to a file in the specified directory.

Parameters

string $domain

Domain to bind

Returns

string
Domain binded

_parseLiteralValuesource protected

_parseLiteralValue( string $string )

Auxiliary function to parse a symbol from a locale definition file

Parameters

string $string

Symbol to be parsed

Returns

string
parsed symbol

_pluralGuesssource protected

_pluralGuess( string $header , integer $n )

Attempts to find the plural form of a string.

Parameters

string $header

Type

integer $n

Number

Returns

integer
plural match

Link

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

_translateTimesource protected

_translateTime( string $format , string $domain )

Returns a Time format definition from corresponding domain

Parameters

string $format

Format to be translated

string $domain

Domain where format is stored

Returns

mixed
translated format string if only value or array of translated strings for corresponding format.

clearsource public static

clear( )

Clears the domains internal data array. Useful for testing i18n.

domainssource public static

domains( )

Get the loaded domains cache.

Returns

array
array

getInstancesource public static

getInstance( )

Return a static instance of the I18n class

Returns

I18n
I18n

insertArgssource public static

insertArgs( string $translated , array $args )

Puts the parameters in raw translated strings

Parameters

string $translated

The raw translated string

array $args

The arguments to put in the translation

Returns

string
Translated string with arguments

loadLocaleDefinitionsource public static

loadLocaleDefinition( string $filename )

Parses a locale definition file following the POSIX standard

Parameters

string $filename

Locale definition filename

Returns

mixed
Array of definitions on success or false on failure

loadMosource public static

loadMo( string $filename )

Loads the binary .mo file and returns array of translations

Parameters

string $filename

Binary .mo file to load

Returns

mixed
Array of translations on success or false on failure

Link

https://www.gnu.org/software/gettext/manual/html_node/MO-Files.html

loadPosource public static

loadPo( string $filename )

Loads the text .po file and returns array of translations

Parameters

string $filename

Text .po file to load

Returns

mixed
Array of translations on success or false on failure

translatesource public static

translate( string $singular , string $plural null , string $domain null , string $category I18n::LC_MESSAGES , integer $count null , string $language null , string $context null )

Used by the translation functions in basics.php Returns a translated string based on current language and translation files stored in locale folder

Parameters

string $singular

String to translate

string $plural optional null

Plural string (if any)

string $domain optional null

Domain The domain of the translation. Domains are often used by plugin translations. If null, the default domain will be used.

string $category optional I18n::LC_MESSAGES

Category The integer value of the category to use.

integer $count optional null

Count Count is used with $plural to choose the correct plural form.

string $language optional null

Language to translate string to. If null it checks for language in session followed by Config.language configuration variable.

string $context optional null

Context The context of the translation, e.g a verb or a noun.

Returns

string
translated string.

Throws

CakeException
When '' is provided as a domain.

array(
    'LC_ALL', 'LC_COLLATE', 'LC_CTYPE', 'LC_MONETARY', 'LC_NUMERIC', 'LC_TIME', 'LC_MESSAGES'
)

array()

null

null

false

'LC_MESSAGES'

'default'

null

null