方法

GLibKeyFileget_value

since: 2.6

声明 [src]

gchar*
g_key_file_get_value (
  GKeyFile* key_file,
  const gchar* group_name,
  const gchar* key,
  GError** error
)

描述 [src]

返回与 group_name 下 key 关联的原始值。使用 g_key_file_get_string() 获取未转义的 UTF-8 字符串。

如果找不到键，则返回 NULL 并将 error 设置为 G_KEY_FILE_ERROR_KEY_NOT_FOUND。如果找不到 group_name，则返回 NULL 并将 error 设置为 G_KEY_FILE_ERROR_GROUP_NOT_FOUND。

since: 2.6

参数

group_name

类型: const gchar*

一个组名。

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

类型: const gchar*

一个键。

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

类型: GError **

可恢复错误的返回位置。

该参数可以为 NULL。
如果返回位置不是 NULL，则必须将其初始化为 NULL GError*。
如果没有错误，方法将使参数保持初始化为 NULL。
如果在发生错误的情况下，参数将被设置为一个新的分配的 GError；调用者将获取数据的所有权，并负责释放它。

返回值

类型: gchar*

一个新的字符串或者当指定的键找不到时为 NULL。

方法调用者将获取返回数据的所有权，并负责释放它。
值是一个以 NUL 结尾的 UTF-8 字符串。