方法

GioFileload_contents_finish

声明 [源]

gboolean
g_file_load_contents_finish (
  GFile* file,
  GAsyncResult* res,
  char** contents,
  gsize* length,
  char** etag_out,
  GError** error
)

描述 [源]

完成对文件内容的异步加载。内容放置在 contents 中,length 设置为 contents 字符串的大小。当不再需要时,应使用 g_free() 释放 contents。如果存在 etag_out,它将被设置为新实体的标签。

参数

res

类型: GAsyncResult

一个 GAsyncResult

数据归调用者所有。
contents

类型: 一个 guint8 数组

放置文件内容的存储位置。

函数将设置该参数。
数组的长度由 length 参数指定。
方法调用者将获取返回的数据的所有权,并负责释放它。
length

类型: gsize*

放置文件内容长度的存储位置,或 NULL 如果不需要长度。

函数将设置该参数。
该参数可以是 NULL
etag_out

类型: char**

放置文件当前实体标签的存储位置,或 NULL 如果不需要实体标签。

函数将设置该参数。
方法可以将此参数设置为 NULL
该参数可以是 NULL
方法调用者将获取返回的数据的所有权,并负责释放它。
该值是一个以 NUL 结尾的 UTF-8 字符串。
error

类型: GError **

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

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

返回值

类型: gboolean

TRUE 表示加载成功。如果 FALSE 并且存在 error,它将适当地设置。