方法

GLibKeyFileget_keys

自：2.6

声明 [src]

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

描述 [src]

返回指定组名 group_name 的所有键。返回的键数组会是 NULL 结尾，因此 length 可以选择为 NULL。如果无法找到 group_name，则返回 NULL 并将 error 设置为 G_KEY_FILE_ERROR_GROUP_NOT_FOUND。

自：2.6

参数

group_name

类型： const gchar*

一个组名称。

数据由方法的调用者拥有。

该值是一个以 NUL 结尾的 UTF-8 字符串。

length

类型： gsize*

返回返回键的数量，或 NULL。

该参数将由函数设置。

参数可以是 NULL。

error

类型： GError **

可恢复错误的返回位置。

参数可以是 NULL。

如果返回位置不是NULL，则必须将其初始化为一个NULL的GError*。

如果没有错误，则方法将把参数初始化为NULL。

错误发生时，参数将被设置为一个新的GError分配；调用者将获取数据的所有权，并负责释放它。

返回值

类型： 一个utf8数组

一个新分配的以NULL结尾的字符串数组。使用g_strfreev()来释放它。

数组是以NULL结尾的。

方法调用者将获取返回数据的所有权，并负责释放它。

每个元素是一个以NUL结尾的UTF-8字符串。