方法

GLibKeyFileget_string_list

自 2.6 起可用

声明 [src]

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

描述 [src]

返回与 keygroup_name 下的值。

如果找不到密钥,返回 NULL 并将 error 设置为 G_KEY_FILE_ERROR_KEY_NOT_FOUND。如果找不到 group_name,返回 NULL 并将 error 设置为 G_KEY_FILE_ERROR_GROUP_NOT_FOUND

自 2.6 起可用

参数

group_name

类型: const gchar*

组名。

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

类型: const gchar*

密钥。

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

类型: gsize*

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

此参数将由函数设置。
此参数可以是 NULL
error

类型: GError **

一个可恢复错误的返回位置的返回位置。

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

返回值

类型:一个 utf8 数组

一个以 NULL 结尾的字符串数组,或者如果指定的密钥找不到,则为 NULL。应使用 g_strfreev() 释放该数组。

数组以 NULL 结尾。
数组的长度在 length 参数中。
方法调用者承担返回数据的所有权,并负责释放它。
每个元素是一个以 NUL 结尾的 UTF-8 字符串。