unsigned char f_findnext( F_FIND *pxFindStruct );
Finds the next file or directory within a FAT file system directory. Call f_findfirst() to find the first file or directory, then f_findnext() to find subsequent files and directories - the same instance of the F_FIND object must be used with both the findfirst and findnext functions.
Parameters:
| pxFindStruct |
A structure in which the 'find' information is stored.
The structure must be completed by a successful call to
f_findfirst() before it can be passed to f_findnext().
|
| F_NO_ERROR |
The call to f_findnext() was successful and pxFindStruct
was populated.
|
| Any other value |
The call to f_findnext() 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_findnext( "/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_findnext() API function