方法

GLibBookmarkFileload_from_data_dirs

自 2.12

声明 [src]

gboolean
g_bookmark_file_load_from_data_dirs (
  GBookmarkFile* bookmark,
  const gchar* file,
  gchar** full_path,
  GError** error
)

描述 [src]

此函数会在 g_get_user_data_dir() 和 g_get_system_data_dirs() 返回的路径中查找名为 file 的桌面书签文件，将文件加载到 bookmark 中，并以 full_path 返回文件的完整路径。如果无法加载文件，则将 error 设置为 GFileError 或 GBookmarkFileError。

自 2.12 起可用

参数

file

类型: const gchar*

要打开和解析的文件名的相对路径。

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

该值是平台原生的字符串，在 Unix 上使用首选的操作系统编码，在 Windows 上使用 UTF-8。

完整路径

类型: gchar**

返回包含文件完整路径的字符串的位置，或者NULL。

该参数将由函数设置。

该参数可以是NULL。

方法调用方负责获取返回数据的所有权，并负责释放它。

该值是平台原生的字符串，在 Unix 上使用首选的操作系统编码，在 Windows 上使用 UTF-8。

错误

类型: GError **

恢复性错误的返回位置。

该参数可以是NULL。

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

如果没有错误，方法将使参数保持初始化为NULL。

发生错误时，参数将设置为新的分配的GError；调用方将获得数据的所有权，并负责释放它。

返回值

类型: gboolean

如果可以加载键文件，则为TRUE，否则为FALSE。