方法

GLibKeyFileget_locale_string

自从:2.6

声明 [源]

gchar*
g_key_file_get_locale_string (
  GKeyFile* key_file,
  const gchar* group_name,
  const gchar* key,
  const gchar* locale,
  GError** error
)

描述 [源]

如果可选,返回在给定 locale 下与 group_name 相关的 key 的值。如果 localeNULL,则假定当前区域设置。

如果 locale 非空,或当前区域设置将在 GKeyFile 的整个生命周期中改变,必须使用 G_KEY_FILE_KEEP_TRANSLATIONS 载入,以便载入所有区域的字符串。

如果找不到 key,则返回 NULL 并设置 errorG_KEY_FILE_ERROR_KEY_NOT_FOUND。如果关联的值无法解释或找不到合适的翻译,则返回未翻译的值。

自从:2.6

参数

group_name

类型: const gchar*

一个组名称。

数据由方法调用者拥有。
该值是一个空终止的 UTF-8 字符串。
关键字

类型: const gchar*

一个关键字。

数据由方法调用者拥有。
该值是一个空终止的 UTF-8 字符串。
区域设置

类型: const gchar*

区域标识符或 NULL

参数可以是 NULL
数据由方法调用者拥有。
该值是一个空终止的 UTF-8 字符串。
错误

类型: GError **

可恢复错误的返回位置。

参数可以是 NULL
如果返回位置不是 NULL,则必须将其初始化为 NULLGError
如果没有错误,方法将通过参数初始化为 NULL
发生错误时,参数将被设置为一个新分配的 GError;调用者将接收数据所有权,并负责释放它。

返回值

类型: gchar*

一个新分配的字符串或无法找到指定的关键字时为 NULL

方法调用者接收返回数据的所有权,并负责释放它。
该值是一个空终止的 UTF-8 字符串。