The f_findfirst function searches a directroy for an item.
FRESULT f_findfirst ( DIR* dp, /* [OUT] Poninter to the directory object */ FILINFO* fno, /* [OUT] Pointer to the file information structure */ const TCHAR* path, /* [IN] Pointer to the directory name to be opened */ const TCHAR* pattern /* [IN] Pointer to the matching pattern string */ );
FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_NO_PATH, FR_INVALID_NAME, FR_INVALID_OBJECT, FR_INVALID_DRIVE, FR_NOT_ENABLED, FR_NO_FILESYSTEM, FR_TIMEOUT, FR_NOT_ENOUGH_CORE, FR_TOO_MANY_OPEN_FILES
After the directory specified by path could be opened, it starts to search the directory for items with the matching pattern specified by pattern. If the first item is found, the information about the item is stored into the file information structure fno.
The matching pattern can contain wildcard characters (? and *). For example, a ? matches an any character, an * matches an any string in length of zero or longer and ???* matches an any string in length of 3 characters or longer. When LFN is enabled, only fname[] is tested when FF_USE_FIND == 1 and also altname[] is tested when FF_USE_FIND == 2. In this revision, there are some differences listed below between FatFs and standard systems in matching condition.
This is a wrapper function of f_opendir and f_readdir function. Available when FF_USE_FIND >= 1 and FF_FS_MINIMIZE <= 1.
/* Search a directory for objects and display it */ void find_image_file (void) { FRESULT fr; /* Return value */ DIR dj; /* Directory object */ FILINFO fno; /* File information */ fr = f_findfirst(&dj, &fno, "", "dsc*.jpg"); /* Start to search for photo files */ while (fr == FR_OK && fno.fname[0]) { /* Repeat while an item is found */ printf("%s\n", fno.fname); /* Print the object name */ fr = f_findnext(&dj, &fno); /* Search for next item */ } f_closedir(&dj); }