方法
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
;调用者将接管数据,并负责释放它。