方法
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,则必须将其初始化为一个NULLGError*。如果没有错误,则方法将使该参数保持 NULL初始化。在发生错误的情况下,参数将被设置为一个新的 GError;调用者将接管数据,并负责释放它。