header_file.h
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.
|
Returns:
Null
|
The file could not be opened.
|
Any other value
|
The returned value is the handle to the opened file.
|
See also
f_open.html, f_seteof().
Example usage:
void vSampleFunction( char *pcFileName, unsigned long ulLength )
{
F_FILE *pxFile;
pxFile = f_truncate( pcFileName, ulLength );
if( pxFile == NULL )
{
}
else
{
f_close( pxFile );
}
}
Example use of the f_truncate() API function
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.