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