unsigned char f_findfirst( const char *pcFileName, F_FIND *pxFindStruct );
Finds the first file or directory in a FAT file system directory. Call f_findfirst() to find the first file or directory, then f_findnext() to find subsequent files and directories.
Parameters:
| pcFileName |
Name/path of the files to find (see the example below).
|
| pxFindStruct |
A structure in which the 'find' information is stored.
|
| F_NO_ERROR |
The call to f_findfirst() was successful and pxFindStruct
was populated.
|
| Any other value |
The call to f_findfirst() was not successful. The return
value holds the error code.
|
See also
Example usage:
void vAFunction( void ) { F_FIND xFindStruct; /* Print out information on every file in the subdirectory "subdir". */ if( f_findfirst( "/subdir/*.*", &xFindStruct ) == F_NO_ERROR ) { do { printf( filename:%s, xFindStruct.filename ); if( ( xFindStruct.attr & F_ATTR_DIR ) != 0 ) { printf ( "is a directory directory\r\n" ); } else { printf ( "is a file of size %d\r\n", xFindStruct.filesize ); } } while( f_findnext( &xFindStruct ) == F_NO_ERROR ); } } Example use of the f_findfirst() API function