方法

GLibKeyFileget_locale_string_list

自从:2.6

声明 [src]

gchar**
g_key_file_get_locale_string_list (
  GKeyFile* key_file,
  const gchar* group_name,
  const gchar* key,
  const gchar* locale,
  gsize* length,
  GError** error
)

描述 [src]

如果可用,返回在给定locale下翻译的与keygroup_name相关的值。如果localeNULL,则假定当前区域设置。

如果locale不为NULL,或者当前区域设置在GKeyFile的生命周期内将改变,必须用G_KEY_FILE_KEEP_TRANSLATIONS载入以加载所有区域设置的字符串。

如果找不到key,则返回NULL并将error设置为G_KEY_FILE_ERROR_KEY_NOT_FOUND。如果无法解释与key关联的值或找不到适当的翻译,则返回未翻译的值。返回的数组以NULL终止,因此length可以选择为NULL

自从:2.6

参数

group_name

类型: const gchar*

一个分组名称。

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

类型: const gchar*

一个键。

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

类型: const gchar*

一个区域设置标识符或NULL

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

类型: gsize*

返回字符串数量的位置或NULL

该参数将由函数设置。
参数可以是NULL
错误

类型: GError **

恢复错误的返回位置。

参数可以是NULL
如果返回位置不是NULL,则必须将其初始化为空的GError*
如果没有错误,方法将保留参数初始化为NULL
如果发生错误,参数将设置为一个新的GError;调用者将获得数据的所有权,并负责释放它。

返回值

类型: 一个utf8数组

分配的新字符串数组(以NULL终止),如果找不到键则为NULL。应该使用g_strfreev()释放字符串数组。

该数组以NULL终止。
数组的长度在长度参数中。
方法调用者获得返回数据的所有权,并负责释放它。
每个元素是一个以空字符终止的UTF-8字符串。