Joomla! 框架 3.x API » \Joomla\Language\Language

翻译函数，模仿 php gettext（别名 _）函数。

_( string,  jsSafe = false,  interpretBackSlashes = true) :

已弃用

该函数检查 $jsSafe 是否为真，然后检查 $interpretBackslashes 是否为真。

参见	Language::translate()
自从	1.0
已弃用	3.0 使用 translate 代替

参数

字符串: string要翻译的字符串
jsSafe: bool使结果对 JavaScript 安全
interpretBackSlashes: bool解释 \t 和 \n

响应

string字符串的翻译

激活语言默认信息的构造函数。

__construct(\Joomla\Language\ParserRegistry parserRegistry,  path,  lang = '',  debug = false) :

自从	1.0

参数

parserRegistry: ParserRegistry包含支持的文件解析器的注册表
path: string语言文件夹的基路径
lang: string语言
debug: bool指示是否启用了语言调试

响应

混合

调试语言文件

debugFile( filename) :

自从	2.0.0-alpha

参数

filename: string要调试文件的绝对路径

响应

int解析错误数量

检查语言是否存在。

exists( lang,  basePath = '') :

static deprecated

这是一个简单的快速检查，用于检查应该包含给定用户的语言文件的目录。

参见	LanguageHelper::exists()
自从	1.0
已弃用	3.0 使用 LanguageHelper::exists() 代替

参数

lang: string要检查的语言。
basePath: string要检查的可选路径。

响应

bool如果语言存在，则为真。

获取元数据语言属性。

get( property,  default = null) :

自从	1.0

参数

property: string属性的名称。
default: mixed默认值。

响应

mixed属性的值。

获取实例的基路径。

getBasePath() :

自从	2.0.0-alpha

响应

字符串

确定谁调用了 Language 或 Text。

getCallerInfo() :

自从	1.0

响应

mixed调用者信息，如果不可用，则为 null

获取语言的消息目录。

getCatalogue() : \Joomla\Language\MessageCatalogue

自从	2.0.0-alpha

响应

MessageCatalogue

获取 Debug 属性。

getDebug() :

自从	1.0

响应

bool在调试模式下为真。

获取默认语言代码。

getDefault() :

自从	1.0

响应

string语言代码。

获取处于错误状态的语言文件列表。

getErrorFiles() : mixed||string|int

自从	1.0

响应

array<string|int, mixed>

获取此语言的一周的第一天。

getFirstDay() :

自从	1.0

响应

int根据语言的一周的第一天

返回某个区域的已知语言列表

getKnownLanguages( basePath = '') : mixed||string|int

static deprecated

参见	LanguageHelper::getKnownLanguages()
自从	1.0
已弃用	3.0 使用 LanguageHelper::getKnownLanguages() 代替

参数

basePath: string要使用的基路径

响应

array<string|int, mixed>语言文件和真实名称的键值对。

获取当前语言代码。

getLanguage() :

自从	1.0

响应

string语言代码

获取语言的路径

getLanguagePath( basePath = '',  language = '') :

static deprecated

参见	LanguageHelper::getLanguagePath()
自从	1.0
已弃用	3.0 使用 LanguageHelper::getLanguagePath() 代替

参数

basePath: string要使用的基路径。
language: string语言标签。

响应

string与语言相关的路径或 null。

根据当前语言获取语言区域设置。

getLocale() : mixed||string|int

自从	1.0

响应

array<string|int, mixed>根据语言的区域设置。

返回包含元数据的关联数组。

getMetadata( lang,  basePath) :

static deprecated

参见	LanguageHelper::getMetadata()
自从	1.0
已弃用	3.0 使用 LanguageHelper::getMetadata() 代替

参数

lang: string语言的名称。
basePath: string语言文件夹的文件路径。

响应

mixed如果 $lang 存在，则返回包含语言元数据的键值对，否则返回 NULL。

Name 的 getter。

getName() :

自从	1.0

响应

string语言的官方名称元素。

获取正在跟踪的孤立字符串列表。

getOrphans() : mixed||string|int

自从	1.0

响应

array<string|int, mixed>孤立文本。

获取已加载的语言文件列表。

getPaths( extension = null) : mixed||string|int

自从	1.0

参数

extension: string可选的扩展名称。

响应

array<string|int, mixed>

返回复数规则的后缀数组。

getPluralSuffixes( count) : string||string|int

自从	1.0

参数

count: int规则适用的计数数字。

响应

array<string|int, string>后缀数组。

语言标签的 getter（如 RFC 3066 中定义的那样）

getTag() :

自从	1.0

响应

string语言标签。

获取已使用字符串列表。

getUsed() : mixed||string|int

已使用字符串是指已请求并找到的字符串，无论作为字符串还是常量。

自从	1.0

响应

array<string|int, mixed>已使用字符串。

获取此语言的周末日期。

getWeekEnd() :

自从	2.0.0-alpha

响应

string根据语言，以逗号分隔的一周的周末日期

确定键是否存在。

hasKey( string) :

自从	1.0

参数

字符串: string要检查的键。

响应

bool如果键存在，则为真。

获取 RTL 属性。

isRtl() :

自从	1.0

响应

bool如果它是 RTL 语言，则为真。

加载单个语言文件并将结果追加到现有字符串

load( extension = 'joomla',  basePath = '',  lang = null,  reload = false) :

自从	1.0

参数

extension: string应加载语言文件的扩展名。
basePath: string要使用的基路径。
lang: string要加载的语言，默认情况下为 null，表示当前语言。
reload: bool标志，如果设置为 true，将强制重新加载语言。

响应

bool如果文件已成功加载，则为真。

加载语言文件。

loadLanguage( filename,  extension = 'unknown') :

此方法不会记录文件的成功加载 - 请改用 load()。

参见	Language::load()
自从	1.0

参数

filename: string文件的名称。
extension: string扩展名的名称。

响应

bool如果语言已添加新字符串，则为真

解析语言文件。

parse( filename) : mixed||string|int

自从	1.0

参数

filename: string文件的名称。

响应

array<string|int, mixed>解析后的字符串数组。

parseLanguageFiles( dir = null) : mixed||string|int

static deprecated

参见	LanguageHelper::parseLanguageFiles()
自从	1.0
已弃用	3.0 使用 LanguageHelper::parseLanguageFiles() 代替

参数

dir: string文件目录。

响应

array<string|int, mixed>数组，保存找到的语言，以文件名 => 真实名称对的形式。

解析 XML 文件以获取语言信息。

parseXmlLanguageFile( path) :

static deprecated

参见	LanguageHelper::parseXMLLanguageFile()
自从	1.0
已弃用	3.0 使用 LanguageHelper::parseXMLLanguageFile() 代替

参数

path: stringXML 文件的路径。

响应

mixed数组，保存找到的元数据，以键 => 值对的形式，或在 XML 文件无效时保存 null

设置语言的消息目录。

setCatalogue(\Joomla\Language\MessageCatalogue catalogue) :

自从	2.0.0-alpha

参数

catalogue: MessageCatalogue要使用的消息目录。

响应

void

设置 Debug 属性。

setDebug( debug) :

自从	1.0

参数

debug: bool调试设置。

响应

bool以前的值。

设置默认语言代码。

setDefault( lang) :

自从	1.0

参数

lang: string语言代码。

响应

string以前的值。

翻译函数，模仿 php gettext（别名 _）函数。

translate( string,  jsSafe = false,  interpretBackSlashes = true) :

该函数检查 $jsSafe 是否为真，然后检查 $interpretBackslashes 是否为真。

自从	2.0.0-alpha

参数

字符串: string要翻译的字符串
jsSafe: bool使结果对 JavaScript 安全
interpretBackSlashes: bool解释 \t 和 \n

响应

string字符串的翻译

音译函数

transliterate( string) :

此方法处理字符串并将所有带重音的 UTF-8 字符替换为不带重音的 ASCII-7“等效字符”。

自从	1.0
抛出	`RuntimeException`

参数

字符串: string要音译的字符串。

响应

string字符串的音译。

调试语言，如果为真，则突出显示字符串未找到的情况。

自从	1.0

类型

bool

默认语言，在请求的语言中的语言文件不存在时使用。

自从	1.0

类型

字符串

孤立文本数组。

自从	1.0

类型

array<string|int, mixed>

包含语言元数据的数组。

自从	1.0

类型

array<string|int, mixed>

包含语言区域设置的数组，如果不存在则为布尔 null。

自从	1.0

类型

array<string|int, mixed>|bool

要加载的语言。

自从	1.0

类型

字符串

已加载的语言文件的嵌套数组

自从	1.0

类型

array<string|int, mixed>

处于错误状态的语言文件列表

自从	1.0

类型

array<string|int, mixed>

已使用文本数组，在调试期间使用。

自从	1.0

类型

array<string|int, mixed>

加载次数计数器。

自从	1.0

类型

int

用于存储覆盖的数组。

自从	1.0

类型

array<string|int, mixed>

本地化对象。

自从	2.0.0-alpha

类型

LocaliseInterface

LanguageHelper 对象

自从	2.0.0-alpha

类型

LanguageHelper

语言文件夹的基路径

自从	2.0.0-alpha

类型

字符串

MessageCatalogue 对象

自从	2.0.0-alpha

类型

MessageCatalogue

语言解析器注册表

自从	2.0.0-alpha

类型

ParserRegistry