方法

GLibBookmarkFileget_groups

自：2.12 开始

声明 [源]

gchar**
g_bookmark_file_get_groups (
  GBookmarkFile* bookmark,
  const gchar* uri,
  gsize* length,
  GError** error
)

描述 [源]

获取 uri 书签的组名列表。

如果无法找到 URI，则返回 NULL，并将 error 设置为 G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND。

返回的数组以 NULL 终止，因此 length 可选为 NULL。

自：2.12 开始

参数

uri

类型： const gchar*

一个有效的 URI。

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

类型： gsize*

返回字符串长度的位置，或 NULL。

该参数将由函数设置。
该参数可以是 NULL。
错误

类型: GError **

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

该参数可以是 NULL。
如果返回位置不是 NULL，则必须将其初始化为 NULL 的 GError*。
如果没有错误，方法将使该参数初始化为 NULL。
发生错误时，将参数设置为一个新的 GError；调用者将拥有数据，并负责释放它。

返回值

类型: UTF-8 数组

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

数组的长度在 length 参数中。
方法调用者拥有返回的数据，并负责释放它。
每个元素都是一个以 NUL 结尾的 UTF-8 字符串。