方法
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
下翻译的与key
和group_name
相关的值。如果locale
为NULL
,则假定当前区域设置。
如果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
;调用者将获得数据的所有权,并负责释放它。