虚拟方法

GioFileappend_to

声明 [源码位置]

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

描述 [源码位置]

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

默认情况下,创建的文件通常对所有用户都是可读的,但如果在标志中传递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,则必须将其初始化为NULLGError*
如果虚拟函数中没有错误,则将通过参数初始化保留为NULL
在出现错误的情况下,参数将被设置为新分配的GError;调用者将负责拥有数据,并负责释放它。

返回值

类型: GFileOutputStream

GFileOutputStream,或在错误情况下为NULL。使用g_object_unref()释放返回的对象。

方法调用者将获取返回数据的所有权,并负责释放它。