方法

GLibKeyFileget_boolean_list

自:2.6

声明 [源]

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

描述 [源]

返回与 keygroup_name 关联的布尔值。

如果找不到 key,则返回 NULL,并将错误设置为 G_KEY_FILE_ERROR_KEY_NOT_FOUND。同样,如果与 key 关联的值不能解释为布尔值,则返回 NULL,并将错误设置为 G_KEY_FILE_ERROR_INVALID_VALUE

自:2.6

参数

group_name

类型: const gchar*

组名称。

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

类型: const gchar*

一个键。

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

类型: gsize*

返回的布尔值的数量。

参数将由函数设置。
错误

类型: GError **

用于可恢复错误的返回位置。

参数可以是NULL
如果返回位置不是NULL,则必须将其初始化为NULLGError*
如果没有错误,方法将使参数保持为NULL初始化。
出错时,参数将设置为一个新的GError分配;调用者将拥有数据,并负责释放它。

返回值

类型: 一个gboolean数组

与键相关联的值列表作为布尔值,如果没有找到该键或无法解析,则为NULL。当不再需要时,应使用g_free()释放返回的布尔值列表。

数组长度在长度参数中。
方法调用者负责拥有的返回数据容器,但不负责容器内的数据。