方法

GioFileload_bytes

自：2.56

声明 [源]

GBytes*
g_file_load_bytes (
  GFile* file,
  GCancellable* cancellable,
  gchar** etag_out,
  GError** error
)

描述 [源]

加载 file 的内容，并返回一个 GBytes。

如果 file 是基于 URI 的 resource://，则返回的字节将引用嵌入的资源而不是拷贝。否则，此操作等效于调用 g_file_load_contents() 和 g_bytes_new_take()。

对于资源，etag_out 将设置为 NULL。

结果 GBytes 中包含的数据始终以空字符终止，但不包括在 GBytes 长度中。当不再使用时，应该使用 g_bytes_unref() 释放结果 GBytes。

自 2.56 以来可用

参数

cancellable

类型： GCancellable

A GCancellable 或 NULL。

参数可以 NULL。
数据由方法调用者所有。
etag_out

类型： gchar**

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

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

类型： GError **

可恢复错误的返回位置。

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

返回值

类型： GBytes

一个 GBytes 或 NULL 和 error 被设置。

方法调用者将拥有返回的数据，并负责释放它。