FatFs源代码中C语言编程技巧的应用

FatFsFatFs 源代码中源代码中 C C 语言编程技巧的应用语言编程技巧的应用 1 1 FatFsFatFs 的源代码结构的源代码结构 在在不支持重入和长文件名的情况下 用到的文件有不支持重入和长文件名的情况下 用到的文件有 6 6 个个 integer hinteger h diskio hdiskio h diskio cdiskio c ff hff h ffconf hffconf h ff cff c Integer hInteger h 是是数据类型定义的头文件数据类型定义的头文件 C C 语言标准的数据类型有语言标准的数据类型有 charchar shortshort intint longlong floatfloat doubledouble 等 但是等 但是不同的机器平台上不同的机器平台上 同样同样 的数据类型其支持的数据宽度可能是不同的的数据类型其支持的数据宽度可能是不同的 比如在 比如在 8 8 位机上 位机上 intint 是是 1616 位宽位宽 度 而在度 而在 3232 位机上 位机上 intint 是是 3232 位 位 因此移植性高的源代码 都不应该直接使因此移植性高的源代码 都不应该直接使 用这些数据类型 而是利用用这些数据类型 而是利用 tpyedeftpyedef 将所有的数据类型定义新的名字将所有的数据类型定义新的名字 而在源 而在源 代码中使用这些新名字 代码中使用这些新名字 当代码移植到不同的平台时 根据所要求的数据宽度和实际平台上的规定 当代码移植到不同的平台时 根据所要求的数据宽度和实际平台上的规定 再再 重新配置数据类型重新配置数据类型就可以了 而源代码中的类型名称都不用改 我们在就可以了 而源代码中的类型名称都不用改 我们在 STM32STM32 上用到的库文件 上用到的库文件 ucosucos 的类型定义 的类型定义 FatFsFatFs 的类型定义的类型定义都是这样做的 都是这样做的 diskio hdiskio h 包含了包含了 integer hinteger h 定义了一些简单的配置常量 主要是定义了两个 定义了一些简单的配置常量 主要是定义了两个 数据类型 数据类型 一个是一个是 DSTATUSDSTATUS 用于表示磁盘状态 用于表示磁盘状态 它实质上就是 它实质上就是 charchar 类型 类型 一一 个是枚举类型个是枚举类型 DRESULTDRESULT 用来表示磁盘操作的返回结果 用来表示磁盘操作的返回结果 正确还是错误正确还是错误 接下来主要是接下来主要是一些函数的原型声明一些函数的原型声明 其它源文件只要包含了这个头文件 就可 其它源文件只要包含了这个头文件 就可 以调用这些函数 以调用这些函数 再接下来是再接下来是磁盘状态常数和磁盘操作控制代码的定义磁盘状态常数和磁盘操作控制代码的定义 都是用 都是用 definedefine 来实现的 来实现的 Ffconf hFfconf h 都是一些用于配置的常数定义 都是一些用于配置的常数定义 ff hff h 中根据中根据 ffconf hffconf h 中的配置中的配置定义了一些宏常数和定义了一些宏常数和 带参数的宏带参数的宏 主要是定义主要是定义 了了 FATFSFATFS FILFIL DIRDIR 和和 FILINFOFILINFO 四个文件信息结构体四个文件信息结构体 用来存储文件系统 目 用来存储文件系统 目 录 文件的相关信息 录 文件的相关信息 定义了定义了 FRESULTFRESULT 这个枚举类型结构体 大多数的文件操作函数都返回这个类型这个枚举类型结构体 大多数的文件操作函数都返回这个类型 的值 的值 定义了文件访问模式 目录项属性 目录项各属性字节偏移 定义了文件访问模式 目录项属性 目录项各属性字节偏移 BPBBPB 参数表偏移参数表偏移 等 特别重要的是定义了字 双字访问宏等 等 特别重要的是定义了字 双字访问宏等 define define LD WORD ptr LD WORD ptr WORD WORD BYTE ptr WORD WORD BYTE ptr define define LD DWORD ptr LD DWORD ptr DWORD DWORD BYTE ptr DWORD DWORD BYTE ptr define define ST WORD ptr val ST WORD ptr val WORD BYTE ptr WORD val WORD BYTE ptr WORD val define define ST DWORD ptr val ST DWORD ptr val DWORD BYTE ptr DWORD val DWORD BYTE ptr DWORD val 这几个宏在获取和写入文件信息时特别有用 这几个宏在获取和写入文件信息时特别有用 ff cff c 开头也有一些常数宏和带参数宏的定义 开头也有一些常数宏和带参数宏的定义 大多数的变量都在这个定义和初大多数的变量都在这个定义和初 始化 然后主要是所有文件操作函数的定义 始化 然后主要是所有文件操作函数的定义 2 2 FatFsFatFs 中用到的一些中用到的一些 C C 语言技巧语言技巧 1 1 利用宏 条件编译来实现系统的高配置性 利用宏 条件编译来实现系统的高配置性 在在 FatFsFatFs 中 我们可以看到大量类似下面的代码 中 我们可以看到大量类似下面的代码 if if FS RPATH FS RPATH ifif path path path path ThereThere isis a a headingheading separatorseparator path path dj sclustdj sclust 0 0 StripStrip itit andand startstart fromfrom thethe rootroot dirdir elseelse NoNo headingheading saparatorsaparator dj sclustdj sclust dj fs cdir dj fs cdir StartStart fromfrom thethe currentcurrent dirdir else else ifif path path path path StripStrip headingheading separatorseparator ifif existexist path path dj sclustdj sclust 0 0 StartStart fromfrom thethe rootroot dirdir endif endif 而在而在 ffconf hffconf h 中定义宏中定义宏 FS RPATH FS RPATH 的值 可以实现不同的功能 的值 可以实现不同的功能 2 2 利用结构体存储一个对象的所有信息 利用结构体存储一个对象的所有信息 typedeftypedef structstruct FIL FIL FATFS FATFS fs fs PointerPointer toto thethe ownerowner filefile systemsystem objectobject WORDWORD id id OwnerOwner filefile systemsystem mountmount IDID BYTEBYTE flag flag FileFile statusstatus flagsflags BYTEBYTE csect csect SectorSector addressaddress inin thethe clustercluster DWORDDWORD fptr fptr FileFile R WR W pointerpointer DWORDDWORD fsize fsize FileFile sizesize DWORDDWORD org clust org clust FileFile startstart clustercluster DWORDDWORD curr clust curr clust CurrentCurrent clustercluster DWORDDWORD dsect dsect CurrentCurrent datadata sectorsector if if FS READONLY FS READONLY DWORDDWORD dir sect dir sect SectorSector containingcontaining thethe directorydirectory entryentry BYTE BYTE dir ptr dir ptr PonterPonter toto thethe directorydirectory entryentry inin thethe windowwindow endif endif if if FS TINY FS TINY BYTEBYTE buf MAX SS buf MAX SS FileFile R WR W bufferbuffer endif endif FIL FIL 文件的操作就通过这样的结构体来进行 文件的操作就通过这样的结构体来进行 3 3 统一所用文件操作函数的模式 统一所用文件操作函数的模式 几乎所有的函数都几乎所有的函数都返回返回 FRESULTFRESULT 类型 而类型 而 FRESULTFRESULT 是通过是通过 typedeftypedef 定义的一种定义的一种 枚举变量枚举变量 这样使得函数的风格很清新 易读性强 这样使得函数的风格很清新 易读性强 4 4 带参数宏的巧妙利用 带参数宏的巧妙利用 比如 比如 define define IsUpper c IsUpper c c A LD DWORD dir DIR FileSize 文件大小文件大小 fno fdatefno fdate LD WORD dir DIR WrtDate LD WORD dir DIR WrtDate 这样使得代码的可读性大大增强 这样使得代码的可读性大大增强 5 5 良好的代码书写风格和版本控制 良好的代码书写风格和版本控制 intint f putsf puts constconst char char str str PointerPointer toto th