方法

自 2.12 开始

声明 [源]

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

描述 [源]

返回在 group_name 下与 key 关联的值作为双精度浮点数。

如果找不到 key，则返回 NULL 并将 error 设置为 G_KEY_FILE_ERROR_KEY_NOT_FOUND。同样，如果与 key 关联的值无法解释为双精度浮点数，则返回 NULL 并将 error 设置为 G_KEY_FILE_ERROR_INVALID_VALUE。

自 2.12 开始可用

参数

group_name

类型: const gchar*

一个组名称。

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

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

key

类型: const gchar*

一个键。

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

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

length

类型: gsize*

返回的双精度浮点数的数量。

该参数将由函数设置。

error

类型: GError **

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

该参数可以是 NULL。

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

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

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

返回值

类型： 一个double数组

the values associated with the key as a list of doubles, or `NULL` if the
key was not found or could not be parsed. The returned list of doubles
should be freed with `g_free()` when no longer needed.

数组的长度在length参数中。

调用方法的一方将获取返回的数据容器所有权，但不对容器内的数据负责。