方法
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;调用者将获得数据的所有权,并负责释放它。