header_file.h
long f_filelength( const char * pcFileName );
Returns the length of a file in the FAT file system.
Parameters:
pcFileName
|
The name of the file (with or without a path) being queried.
The name is specified as a standard null terminated C string.
|
Returns:
0
|
Either:
-
The file does not exist.
-
F_FS_THREAD_AWARE is set to 1 and a file system
lock could not be obtained before F_MAX_LOCK_WAIT_TICKS
elapsed.
|
Any other value
|
The length of the file in bytes.
|
Example usage:
long lReadFile( char *pcFileName, char *pcBuffer, long lBufferSize )
{
F_FILE *pxFile;
long lFileSize = 0;
pxFile = f_open( pcFileName, "r" );
if( pxFile != NULL )
{
lFileSize = f_filelength( pcFileName );
if( lFileSize <= lBufferSize )
{
f_read( pcBuffer, lFileSize, 1, pxFile );
f_close( pxFile );
}
}
return lFileSize;
}
Example use of the f_filelength() API function
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.