方法

GioFileload_contents

声明 [src]

gboolean
g_file_load_contents (
  GFile* file,
  GCancellable* cancellable,
  char** contents,
  gsize* length,
  char** etag_out,
  GError** error
)

描述 [src]

将文件的 内容加载到内存中。数据始终以空字符终止,但不会包含在结果 length 中。返回的 contents 应该在使用完毕后用 g_free() 释放。

如果 cancellable 不为 NULL,则可以从另一个线程触发可取消对象来取消操作。如果操作被取消,将返回错误 G_IO_ERROR_CANCELLED

参数

cancellable

类型: GCancellable

可选的 GCancellable 对象,NULL 表示忽略。

该参数可以为 NULL
数据由该方法调用者拥有。
contents

类型: 一个 guint8 数组

放置文件内容的位置。

该参数将由函数设置。
数组的长度在 length 参数中指定。
该方法调用者将接管返回的数据,并负责释放它。
length

类型: gsize*

放置文件内容长度的位置,或 NULL 表示不需要长度。

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

类型: char**

放置文件当前实体标签的位置,或 NULL 表示不需要实体标签。

该参数将由函数设置。
该方法可以将该参数设置为 NULL
该参数可以为 NULL
该方法调用者将接管返回的数据,并负责释放它。
该值是一个以 NUL 终止的 UTF-8 字符串。
error

类型: GError **

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

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

返回值

类型: gboolean

TRUE 如果文件内容已成功加载。 FALSE 如果发生错误。