方法

GLibKeyFileget_integer_list

自从:2.6

声明 [src]

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

描述 [src]

返回在group_name下与key相关联的整数值。

如果找不到key,则返回NULL并将error设置为G_KEY_FILE_ERROR_KEY_NOT_FOUND。同样,如果与key关联的值无法解释为整数,或者范围超出

gint,则返回NULL

并将error设置为G_KEY_FILE_ERROR_INVALID_VALUE

自2.6版本起提供

参数

group_name

类型: const gchar*

一个组名。

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

类型: const gchar*

一个密钥。

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

类型: gsize*

返回的整数数量。

该参数将由函数设置。
error

类型: GError **

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

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

返回值

类型: 一个 int 数组

the values associated with the key as a list of integers, or `NULL` if
the key was not found or could not be parsed. The returned list of
integers should be freed with `g_free()` when no longer needed.
数组的长度在 length 参数中。
方法调用的调用者将拥有返回的数据容器,但不拥有容器内的数据。