FATFS 初學之 f_opendir/ f_readdir

f_opendir：

/*-----------------------------------------------------------------------*/
/* Create a Directroy Object                                             */
/*-----------------------------------------------------------------------*/

FRESULT f_opendir (
    DIR *dj,            /* Pointer to directory object to create */
    const TCHAR *path    /* Pointer to the directory path */
)
{
    FRESULT res;
    DEF_NAMEBUF;


    res = chk_mounted(&path, &dj->fs, 0);
    if (res == FR_OK) {
        INIT_BUF(*dj);
        res = follow_path(dj, path);            /* Follow the path to the directory */
        FREE_BUF();
        if (res == FR_OK) {                        /* Follow completed */
            if (dj->dir) {                        /* It is not the root dir */
                if (dj->dir[DIR_Attr] & AM_DIR) {    /* The object is a directory */
                    dj->sclust = LD_CLUST(dj->dir);
                } else {                        /* The object is not a directory */
                    res = FR_NO_PATH;
                }
            }
            if (res == FR_OK) {
                dj->id = dj->fs->id;
                res = dir_sdi(dj, 0);            /* Rewind dir */
            }
        }
        if (res == FR_NO_FILE) res = FR_NO_PATH;
    }

    LEAVE_FF(dj->fs, res);
}

函數功能：打開一個目錄

描述：

f_opendir函數當_FS_MINIMIZE <= 1時可用。
f_opendir函數打開一個已存在的目錄，並為后續的調用創建一個目錄對象。該目錄對象結構可以在任何時候不經任何步驟而被丟棄。

 

f_readdir：

/*-----------------------------------------------------------------------*/
/* Read Directory Entry in Sequense                                      */
/*-----------------------------------------------------------------------*/

FRESULT f_readdir (
    DIR *dj,            /* Pointer to the open directory object */
    FILINFO *fno        /* Pointer to file information to return */
)
{
    FRESULT res;
    DEF_NAMEBUF;


    res = validate(dj->fs, dj->id);            /* Check validity of the object */
    if (res == FR_OK) {
        if (!fno) {
            res = dir_sdi(dj, 0);            /* Rewind the directory object */
        } else {
            INIT_BUF(*dj);
            res = dir_read(dj);                /* Read an directory item */
            if (res == FR_NO_FILE) {        /* Reached end of dir */
                dj->sect = 0;
                res = FR_OK;
            }
            if (res == FR_OK) {                /* A valid entry is found */
                get_fileinfo(dj, fno);        /* Get the object information */
                res = dir_next(dj, 0);        /* Increment index for next */
                if (res == FR_NO_FILE) {
                    dj->sect = 0;
                    res = FR_OK;
                }
            }
            FREE_BUF();
        }
    }

    LEAVE_FF(dj->fs, res);
}

函數功能：讀取目錄項

描述：

f_readdir函數當 _FS_MINIMIZE <= 1時可用。
f_readdir函數順序讀取目錄項。目錄中的所有項可以通過重復調用f_readdir函數被讀取。當所有目錄項已被讀取並且沒有項要讀取時，該函數沒有任何錯誤地返回一個空字符串到f_name[]成員中。當 FileInfo給定一個空指針時，目錄對象的讀索引將被回繞。
當LFN功能被使能時，在使用f_readdir函數之前，文件信息結構中的lfname和lfsize必須被初始化為有效數值。lfname是一個返回長文件名的字符串緩沖區指針。lfsize是以字符為單位的字符串緩沖區的大小。如果讀緩沖區或LFN工作緩沖區的大小(對於LFN)不足，或者對象沒有LFN，則一個空字符串將被返回到LFN讀緩沖區。

如果LFN包含任何不能被轉換為 OEM代碼的字符，則一個空字符串將被返回，但是這不是 Unicode API配置的情況。當 lfname是一個空字符串時，沒有LFN的任何數據被返回。當對象沒有 LFN時，任何小型大寫字母可以被包含在SFN中。
當相對路徑功能被使能(_FS_RPATH == 1)時，"."和".."目錄項不會被過濾掉，並且它將出現在讀目錄項中。

 

例：

DIR dir;
FILINFO f_info;
#define MAXDIR 80

// 以下代碼實現讀取根目錄下所有的子目錄名(短文件名)並保存到數組Dirname[MAXDIR][13]中，僅供參考.
if(f_opendir(&dir,"")!=FR_OK)
{
    // 錯誤處理代碼...
}
memset(Dirname[0],0,13*MAXDIR);
maxdir=1;

while(1)
{
    if(f_readdir(&dir,&f_info)==FR_OK)
    {
        if(f_info.fname[0]==0)break;
    }
    else break;
    
    if(f_info.fattrib & AM_DIR)        // 目錄
    {
        if(maxdir<MAXDIR)
        {
            strncpy(Dirname[maxdir],f_info.fname,13);
            maxdir++;
        }
    }
}