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++;
        }
    }
}