FileT.create

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.

template FileT(TStruct)
create

Parameters

flags GFileCreateFlags

a set of #GFileCreateFlags

cancellable Cancellable

optional #GCancellable object, %NULL to ignore

Return Value

a #GFileOutputStream for the newly created file, or %NULL on error. Free the returned object with g_object_unref().

Throws

GException on failure.

Meta