F_FILE * f_truncate( const char * pcFileName, long lTruncateSize );
Opens a file for writing, then sets the length of the file to a specified value. If the specified length is longer than the current file length then the file is extended (rather than truncated) and the new space is padded with zeros. If the specified length is shorter than the current file length then the file is truncated and all data after the truncation point is lost.
Parameters:
| pcFileHandle |
The name of the file being opened and truncated. The
name is specified as a standard null terminated C string.
|
| lTruncateSize |
The length to which the opened file will be truncated/extended.
|
| Null |
The file could not be opened.
|
| Any other value |
The returned value is the handle to the opened file.
|
See also
Example usage:
void vSampleFunction( char *pcFileName, unsigned long ulLength ) { F_FILE *pxFile; /* Open and truncate the file specified by the pcFileName parameter. */ pxFile = f_truncate( pcFileName, ulLength ); if( pxFile == NULL ) { /* The file could not be opened. */ } else { /* The file was opened and the file length was set. */ /* * The file can be accessed here. */ /* Close the file when it is no longer required. */ f_close( pxFile ); } } Example use of the f_truncate() API function