方法
GioFilereplace_contents_async
声明 [源代码]
void
g_file_replace_contents_async (
GFile* file,
const char* contents,
gsize length,
const char* etag,
gboolean make_backup,
GFileCreateFlags flags,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer user_data
)
描述 [源代码]
以异步方式开始用给定的大小为 length 字节的 contents 替换 file。 etag 将替换文档的当前实体标签。
当此操作完成后，将会用 user_data 回调，并且可以调用 g_file_replace_contents_finish() 来最终完成操作。
如果 cancellable 不是 NULL，则可以在另一个线程中触发可取消对象以取消操作。如果操作被取消，则将返回错误 G_IO_ERROR_CANCELLED。
如果 make_backup 是 TRUE，则此函数将尝试创建 file 的备份。
请注意，将不会复制 contents 的副本，因此它必须保持有效，直到 callback 被调用。有关将自动在调用期间保持内容引用（而不进行复制）的 GBytes 版本的说明，请参阅 g_file_replace_contents_bytes_async()。
此方法异步完成。使用 g_file_replace_contents_finish() 在 GAsyncReadyCallback 中获取操作的结果。
参数
contents-
类型： 一个涂有
guint8用于替换文件的字符串内容。
数组的长度由 length参数指定。此数据由方法的调用者拥有。 length-
类型：
gsizecontents中的字节数。 etag-
类型：
const char*文件的一个新的 实体标签，或
NULL。该参数可以是 NULL。此数据由方法的调用者拥有。 值是一个以 NUL 结尾的 UTF-8 字符串。 make_backup-
类型：
gbooleanTRUE如果应该创建备份。 flags-
类型：
GFileCreateFlags一组
GFileCreateFlags。 cancellable-
类型：
GCancellable可选的
GCancellable对象，NULL表示忽略。该参数可以是 NULL。此数据由方法的调用者拥有。 callback-
当请求得到满足时调用的
GAsyncReadyCallback。该参数可以是 NULL。 user_data-
类型：
gpointer传递给回调函数的数据。
该参数可以是 NULL。此数据由方法的调用者拥有。