File.replaceContents

Replaces the contents of file with contents of length bytes. If etag is specified (not NULL) any existing file must have that etag, or the error G_IO_ERROR_WRONG_ETAG will be returned. If make_backup is TRUE, this function will attempt to make a backup of file. 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. The returned new_etag can be used to verify that the file hasn't changed the next time it is saved over.

class File
int
replaceContents

Parameters

contents string

a string containing the new contents for file. [element-type guint8][array length=length]

length gsize

the length of contents in bytes.

etag string

the old entity tag for the document, or NULL. [allow-none]

makeBackup int

TRUE if a backup should be created.

flags GFileCreateFlags

a set of GFileCreateFlags.

newEtag string

a location to a new entity tag for the document. This should be freed with g_free() when no longer needed, or NULL. [allow-none]out

cancellable Cancellable

optional GCancellable object, NULL to ignore.

Return Value

Type: int

TRUE if successful. If an error has occurred, this function will return FALSE and set error appropriately if present.

Throws

GException on failure.

Meta