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.

			GnomeVFS - Filesystem Abstraction library
Top \| Description