f_readdir

ディレクトリ項目を読み出します

FRESULT f_readdir (
  DIR* DirObject,    /* ディレクトリ・ブジェクト構造体へのポインタ */
  FILINFO* FileInfo  /* ファイル情報構造体へのポインタ */
);

引数

DirObject
ディレクトリ・オブジェクト構造体へのポインタを指定します。
FileInfo
読み出したディレクトリ項目を格納するファイル情報構造体へのポインタを指定します。

戻り値

FR_OK (0)
正常終了。
FR_NOT_READY
メディアがセットされていないなど、ディスク・ドライブが動作不能状態。
FR_RW_ERROR
ディスク・エラーまたは内部エラーによる失敗。
FR_INVALID_OBJECT
無効なディレクトリ・オブジェクト。

解説

ディレクトリ項目を順次読み出します。この関数を繰り返し実行することによりディレクトリの全ての項目を読み出すことができます。全ての項目を読み出し、読み出す項目がもう無いときは、f_name[]メンバにヌル文字列が返されます。得られるファイル情報の詳細については FILINFO構造体を参照してください。_FS_MINIMIZE >= 2ではこの関数はサポートされません。

使用例

void scan_files (char* path)
{
    FILINFO finfo;
    DIR dirs;
    int i;

    if (f_opendir(&dirs, path) == FR_OK) {
        i = strlen(path);
        while ((f_readdir(&dirs, &finfo) == FR_OK) && finfo.fname[0]) {
            if (finfo._attrib & AM_DIR) {
                sprintf(&path[i], "/%s", &finfo.fname[0]);
                scan_files(path);
                path[i] = 0;
            } else {
                printf("%s/%s\n", path, &finfo.fname[0]);
            }
        }
    }
}

参照

f_opendir, f_stat, FILINFO, DIR

戻る