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