方法

GioFilecreate

声明 [src]

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

说明 [src]

创建一个新的文件,并返回一个用于写入的输出流。文件必须不存在。

默认情况下创建的文件通常对任何人可读,但如果在flags中传递G_FILE_CREATE_PRIVATE,则文件将只对当前用户可读,在目标文件系统支持的程度上。

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

如果已经存在具有此名称的文件或目录,将返回错误G_IO_ERROR_EXISTS。某些文件系统不允许所有文件名,并可能返回G_IO_ERROR_INVALID_FILENAME错误,如果名称过长,则返回G_IO_ERROR_FILENAME_TOO_LONG。也可能会出现其他错误,这取决于文件所在的文件系统类型。

参数

flags

类型: GFileCreateFlags

一组GFileCreateFlags

cancellable

类型: GCancellable

可选的GCancellable对象,NULL代表忽略。

该参数可以是NULL
数据由方法调用者所有。
error

类型: GError **

可恢复错误的返回位置。

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

返回值

类型: GFileOutputStream

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

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