Method
GioFilecreate
Declaration
GFileOutputStream*
g_file_create (
GFile* file,
GFileCreateFlags flags,
GCancellable* cancellable,
GError** error
)
Description
Creates a new file and returns an output stream for writing to it. The file must not already exist.
By default files created are generally readable by everyone,
but if you pass G_FILE_CREATE_PRIVATE
in flags
the file
will be made readable only to the current user, to the level
that is supported on the target filesystem.
If cancellable
is not NULL
, then the operation can be cancelled
by triggering the cancellable object from another thread. If the
operation was cancelled, the error G_IO_ERROR_CANCELLED
will be returned.
If a file or directory with this name already exists the
G_IO_ERROR_EXISTS
error will be returned. Some file systems don’t
allow all file names, and may return an G_IO_ERROR_INVALID_FILENAME
error, and if the name is to long G_IO_ERROR_FILENAME_TOO_LONG
will
be returned. Other errors are possible too, and depend on what kind
of filesystem the file is on.
Parameters
flags |
GFileCreateFlags |
A set of |
|
cancellable |
GCancellable |
Optional |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | GFileOutputStream |
A |
|
The caller of the method takes ownership of the data, and is responsible for freeing it. |