Truncating Files

Truncating Files — Force files to a particular length

Synopsis




GnomeVFSResult gnome_vfs_truncate           (const gchar *text_uri,
                                             GnomeVFSFileSize length);
GnomeVFSResult gnome_vfs_truncate_uri       (GnomeVFSURI *uri,
                                             GnomeVFSFileSize length);
GnomeVFSResult gnome_vfs_truncate_handle    (GnomeVFSHandle *handle,
                                             GnomeVFSFileSize length);

Description

Truncation of files is used to force them to a particular length. If a file longer than specified, the trailing bytes are discarded, if it is shorter than specified it is padded with zeros.

Details

gnome_vfs_truncate ()

GnomeVFSResult gnome_vfs_truncate           (const gchar *text_uri,
                                             GnomeVFSFileSize length);

Truncate the file at text_uri to length bytes.

text_uri : string representing the file to be truncated.
length : length of the new file at text_uri.
Returns : an integer representing the result of the operation.

gnome_vfs_truncate_uri ()

GnomeVFSResult gnome_vfs_truncate_uri       (GnomeVFSURI *uri,
                                             GnomeVFSFileSize length);

Truncate the file at uri to be only length bytes. Data past length bytes will be discarded.

uri : uri of the file to be truncated.
length : length of the new file at uri.
Returns : an integer representing the result of the operation.

gnome_vfs_truncate_handle ()

GnomeVFSResult gnome_vfs_truncate_handle    (GnomeVFSHandle *handle,
                                             GnomeVFSFileSize length);

Truncate the file pointed to by handle to be only length bytes. Data past length bytes will be discarded.

handle : a handle to the file to be truncated.
length : length of the new file the handle is open to.
Returns : an integer representing the result of the operation.