方法

GioFileappend_to

声明 [src]

GFileOutputStream*
g_file_append_to (
  GFile* file,
  GFileCreateFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

获取用于向文件追加数据的输出流。如果文件尚不存在,则将其创建。

默认情况下创建的文件通常可供所有人阅读,但如果在 flags 中传递 G_FILE_CREATE_PRIVATE,则文件将仅对当前用户可读,达到目标文件系统支持的程度。

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

一些文件系统不允许所有文件名,并可能返回 G_IO_ERROR_INVALID_FILENAME 错误。如果文件是目录,则返回 G_IO_ERROR_IS_DIRECTORY 错误。也可能有其他错误,取决于文件的文件系统类型。

参数

flags

类型: GFileCreateFlags

一组 GFileCreateFlags

cancellable

类型: GCancellable

可选的 GCancellable 对象,NULL 为忽略。

参数可以为 NULL
数据属于方法调用者。
error

类型: GError **

可恢复错误的返回位置。

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

返回值

类型: GFileOutputStream

一个 GFileOutputStream,错误时为 NULL。使用 g_object_unref() 释放返回的对象。

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