学步园

Fatfs文件系统分析(2)-ff.c/ff.h文件分析

 1、结构分析

  1）FATFS

 typedef struct {
 BYTE fs_type;   //  系统类型，为0时系统没有被挂载

 BYTE drv;          // 
物理磁盘驱动号

 BYTE csize;       // 
每簇的扇区数目，  簇是文件数据分配的基本单位   

 BYTE n_fats;     // 
文件分配表的数目，一般为两个（一个备份fat表）     

          //Fatfs文件系统应该是:引导扇区，文件分配表2个，根目录区，和数据区
     
 BYTE wflag;      //  文件活动窗体是否改动标志，为1要回写 

 BYTE fsi_flag;   // 
文件信息回写标志 

 WORD id;         // 
文件系统加载id号 

 WORD n_rootdir;     //根目录区目录项数目（针对FAT12/16，FAT32不使用） 

#if _MAX_SS != 512
 WORD ssize;     //  每扇区多少字节
#endif

#if _FS_REENTRANT
 _SYNC_t sobj;   // 允许重入，则定义同步对象 

#endif

#if !_FS_READONLY
 DWORD last_clust;  // 最新分配的簇  

 DWORD free_clust;  //
空闲簇
 DWORD fsi_sector;  // 文件信息扇区（仅用于FAT32）
#endif

#if _FS_RPATH
 DWORD cdir;  //使用相对路径，文件系统的当前起始路径  0（root路径）

#endif

 DWORD n_fatent; //文件分配表占用的扇区    n_fatent=数据簇数目+2

 DWORD fsize;       //每FAT表有多少个扇区      

 DWORD fatbase;  //文件分配表开始扇区    

 DWORD dirbase;  //
如果是FAT32，根目录开始扇区需要首先得到 

 DWORD database; //
数据起始扇区    

 DWORD winsect;    // win中当前指定的扇区
 BYTE win[_MAX_SS];  //扇区操作缓存

} FATFS;

 2）FIL

typedef struct {
 FATFS* fs;    // 指向的文件系统 

 WORD id;     // 自身文件系统挂载id号 即 fs->id

 BYTE flag;     // 文件状态 

 BYTE pad1;   //文件在簇里面扇区偏移 （0--fs->csize）

 DWORD fptr; //文件当前读写指针位置，当文件打开时为0 

 DWORD fsize; //文件大小（按字节计算）

 DWORD org_clust;  //
文件起始簇 (0 when fsize==0) 
 DWORD curr_clust;  // 文件当前操作簇
 DWORD dsect;   // 文件当前操作扇区
#if !_FS_READONLY
 DWORD dir_sect;  // 包含路径入口的扇区号 
 BYTE* dir_ptr;       // 目录入口指针
#endif
#if _USE_FASTSEEK
 DWORD* cltbl;      //指向查找映射表的簇 (null on file open)
#endif
#if _FS_SHARE
 UINT lockid;         // 文件锁 ID号 (index of file semaphore table)
#endif
#if !_FS_TINY
 BYTE buf[_MAX_SS];   // 文件读写缓存

#endif
} FIL;

 3）DIR

typedef struct {
 FATFS* fs;          // 对应的文件系统  

 WORD id;           //
自身文件系统挂载id号 
即 fs->id

 WORD index;     //
目前读写索引号  /* Current read/write index number */
 DWORD sclust;  // 目录表起始簇   (0:Root dir) 
 DWORD clust;    // 目前处理的簇   
 DWORD sect;     // 目前簇里对应的扇区

 BYTE* dir;   //指向当前在win[]中的短文件名入口项/* Pointer to the current SFN entry in the win[] 
 BYTE* fn;    //指向短文件名 (in/out) {file[8],ext[3],status[1]}
#if _USE_LFN
 WCHAR* lfn;     //指向长文件名缓冲  /* Pointer to the LFN working buffer */
 WORD lfn_idx;  /* Last matched LFN index number (0xFFFF:No LFN) */
#endif
} DIR;

 4）FILINFO

typedef struct {   //文件目录表项 大小=4+2+2+1+13
 DWORD fsize;   /* File size */            
 WORD fdate;     /* Last modified date */
 WORD ftime;      /* Last modified time */
 BYTE fattrib;       /* Attribute */ // 文件属性
 TCHAR fname[13];  /* Short file name (8.3 format) */
#if _USE_LFN    //长文件名支持
 TCHAR* lfname;    /* Pointer to the LFN buffer */
 UINT  lfsize;           /* Size of LFN buffer in TCHAR */
#endif
} FILINFO;

 

2、应用程序接口

      FatFs 模块为应用程序提供了下列函数，这些函数描述了FatFs能对FAT卷执行哪些操作。

1）f_mount

在FatFs模块上注册/注销一个工作区(文件系统对象)

FRESULT f_mount (

  BYTE  Drive,             /*逻辑驱动器号 */

  FATFS*  FileSystemObject /*工作区指针 */

);

参数

Drive注册/注销工作区的逻辑驱动器号(0-9)。

FileSystemObject工作区(文件系统对象)指针。

返回值

FR_OK (0)函数成功。

FR_INVALID_DRIVE驱动器号无效

描述

f_mount函数在FatFs模块上注册/注销一个工作区。在使用任何其他文件函数之前，必须使用该函数为每个卷注册一个工作区。要注销一个工作区，只要指定FileSystemObject为NULL即可，然后该工作区可以被丢弃。

该函数只初始化给定的工作区，以及将该工作区的地址注册到内部表中，不访问磁盘I/O层。卷装入过程是在f_mount函数后或存储介质改变后的第一次文件访问时完成的。

 

2）f_open

创建/打开一个用于访问文件的文件对象

FRESULT f_open (

  FIL* FileObject,         /*空白文件对象结构指针 */

  const XCHAR* FileName,   /*文件名指针 */

  BYTE ModeFlags           /*模式标志 */

);

参数

FileObject将被创建的文件对象结构的指针。

FileName

NULL结尾的字符串指针，该字符串指定了将被创建或打开的文件名。

ModeFlags指定文件的访问类型和打开方法。它是由下列标志的一个组合指定的。

注意：当 _FS_READONLY == 1时，模式标志 FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS是无效的。

返回值

 

 

 

 3） f_close

关闭一个打开的文件

FRESULT f_close (

  FIL* FileObject          /*文件对象结构的指针 */

);

参数

FileObject指向将被关闭的已打开的文件对象结构的指针。

返回值

FR_OK (0)文件对象已被成功关闭。>FR_DISK_ERR由于底层磁盘I/O函数中的错误，而导致该函数失败。FR_INT_ERR由于一个错误的FAT结构或一个内部错误，而导致该函数失败。

FR_NOT_READY由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。

FR_INVALID_OBJECT文件对象无效。

描述

f_close函数关闭一个打开的文件对象。无论向文件写入任何数据，文件的缓存信息都将被写回到磁盘。该函数成功后，文件对象不再有效，并且可以被丢弃。如果文件对象是在只读模式下打开的，不需要使用该函数，也能被丢弃。

 

4）f_read

从一个文件读取数据

FRESULT f_read (

  FIL* FileObject,         /*文件对象结构的指针 */

  void* Buffer,            /*存储读取数据的缓冲区的指针 */

  UINT ByteToRead,         /*要读取的字节数 */

  UINT* ByteRead           /*返回已读取字节数变量的指针 */

);

参数

FileObject指向将被读取的已打开的文件对象结构的指针。

Buffer指向存储读取数据的缓冲区的指针。

ByteToRead要读取的字节数，UINT范围内。

ByteRead指向返回已读取字节数的UINT变量的指针。在调用该函数后，无论结果如何，数值都是有效的。

返回值

 

 

描述

文件对象中的读/写指针以已读取字节数增加。该函数成功后，应该检查 *ByteRead来检测文件是否结束。在读操作过程中，一旦 *ByteRead < ByteToRead，则读/写指针到达了文件结束位置。

 

5）f_write

写入数据到一个文件

FRESULT f_write (

  FIL* FileObject,         /*文件对象结构的指针 */

  const void* Buffer,      /*存储写入数据的缓冲区的指针 */

  UINT ByteToWrite,        /*要写入的字节数 */

  UINT* ByteWritten        /*返回已写入字节数变量的指针 */

);

参数

FileObject指向将被写入的已打开的文件对象结构的指针。

Buffer指向存储写入数据的缓冲区的指针。

ByteToRead要写入的字节数，UINT范围内。

ByteRead指向返回已写入字节数的UINT变量的指针。在调用该函数后，无论结果如何，数值都是有效的。

返回值

描述

文件对象中的读/写指针以已写入字节数增加。该函数成功后，应该检查 *ByteWritten来检测磁盘是否已满。在写操作过程中，一旦 *ByteWritten < *ByteToWritten，则意味着该卷已满。

 

 6）f_lseek

移动一个打开的文件对象的文件读/写指针。也可以被用来扩展文件大小(簇预分配)。

FRESULT f_lseek (

  FIL* FileObject,         /*文件对象结构指针 */

  DWORD Offset             /*文件字节偏移 */

);

参数

FileObject打开的文件对象的指针

Offset相对于文件起始处的字节数

返回值

FR_OK (0)函数成功。

FR_DISK_ERR由于底层磁盘I/O函数中的错误，而导致该函数失败。

FR_INT_ERR由于一个错误的FAT结构或一个内部错误，而导致该函数失败。

FR_NOT_READY由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。

FR_INVALID_OBJECT文件对象无效。

描述

f_lseek函数当FS_MINIMIZE <= 2时可用。

offset只能被指定为相对于文件起始处的字节数。当在写模式下指定了一个超过文件大小的offset时，文件的大小将被扩展，并且该扩展的区域中的数据是未定义的。这适用于为快速写操作迅速地创建一个大的文件。f_lseek函数成功后，为了确保读/写指针已被正确地移动，必须检查文件对象中的成员fptr。如果fptr不是所期望的值，则发生了下列情况之一。

• 文件结束。指定的offset被钳在文件大小，因为文件已被以只读模式打开。
• 磁盘满。卷上没有足够的空闲空间去扩展文件大小。

例子

 

 7）f_truncate

截断文件大小

FRESULT f_truncate (

  FIL* FileObject          /*文件对象结构指针 */

);

参数

FileObject待截断的打开的文件对象的指针。

返回值

描述

f_truncate函数当_FS_READONLY == 0并且 _FS_MINIMIZE == 0时可用。

f_truncate函数截断文件到当前的文件读/写指针。当文件读/写指针已经指向文件结束时，该函数不起作用。

 

 

8） f_sync

冲洗一个写文件的缓存信息

FRESULT f_sync (

  FIL* FileObject          /*文件对象结构的指针 */

);

参数

FileObject待冲洗的打开的文件对象的指针。

返回值

FR_OK (0)函数成功。

FR_DISK_ERR由于底层磁盘I/O函数中的错误，而导致该函数失败。

FR_INT_ERR由于一个错误的FAT结构或一个内部错误，而导致该函数失败。

FR_NOT_READY由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。

FR_INVALID_OBJECT文件对象无效。

描述

f_sync函数当_FS_READONLY == 0时可用。

f_sync函数和f_close函数执行同样的过程，但是文件仍处于打开状态，并且可以继续对文件执行读/写/移动指针操作。这适用于以写模式长时间打开文件，比如数据记录器。定期的或f_write后立即执行f_sync可以将由于突然断电或移去磁盘而导致数据丢失的风险最小化。在f_close前立即执行f_sync没有作用，因为在f_close中执行了f_sync。换句话说，这两个函数的差异就是文件对象是不是无效的。

 

9）f_opendir

打开一个目录

FRESULT f_opendir (

  DIR* DirObject,          /*空白目录对象结构的指针 */

  const XCHAR* DirName     /*目录名的指针 */

);

参数

DirObject待创建的空白目录对象的指针。

DirName'\0'结尾的字符串指针，该字符串指定了将被打开的目录名。

返回值

描述

f_opendir函数当_FS_MINIMIZE <= 1时可用。

f_opendir函数打开一个已存在的目录，并为后续的调用创建一个目录对象。该目录对象结构可以在任何时候不经任何步骤而被丢弃。

 

 

10）f_readdir

读取目录项

FRESULT f_readdir (

  DIR* DirObject,          /*指向打开的目录对象结构的指针 */

  FILINFO* FileInfo        /*指向文件信息结构的指针 */

);

参数

DirObject打开的目录对象的指针。

FileInfo存储已读取项的文件信息结构指针。

返回值

FR_OK (0)函数成功。

FR_DISK_ERR由于底层磁盘I/O函数中的错误，而导致该函数失败。

FR_INT_ERR由于一个错误的FAT结构或一个内部错误，而导致该函数失败。

FR_NOT_READY由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。

FR_INVALID_OBJECT文件对象无效。

描述

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)时，"."和".."目录项不会被过滤掉，并且它将出现在读目录项中。

例子

 

 

 

11）f_getfree

获取空闲簇的数目

FRESULT f_getfree (

  const XCHAR* Path,       /*驱动器的根目录 */

  DWORD* Clusters,         /*存储空闲簇数目变量的指针 */

  FATFS** FileSystemObject /*文件系统对象指针的指针 */

);

参数

Path'\0'结尾的字符串指针，该字符串指定了逻辑驱动器的目录。

Clusters存储空闲簇数目的DWORD变量的指针。

FileSystemObject相应文件系统对象指针的指针。

返回值

FR_OK (0)函数成功。*Clusters表示空闲簇的数目，并且*FileSystemObject指向文件系统对象。

FR_INVALID_DRIVE驱动器号无效。

FR_NOT_READY由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。

FR_DISK_ERR由于底层磁盘I/O函数中的错误，而导致该函数失败。

FR_INT_ERR由于一个错误的FAT结构或一个内部错误，而导致该函数失败。

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

描述

f_getfree函数当_FS_READONLY == 0并且_FS_MINIMIZE == 0时有效。

f_getfree函数获取驱动器上空闲簇的数目。文件系统对象中的成员csize是每簇中的扇区数，因此，以扇区为单位的空闲空间可以被计算出来。当FAT32卷上的FSInfo结构不同步时，该函数返回一个错误的空闲簇计数。

例子

 

 

12）f_stat

获取文件状态

FRESULT f_stat (

  const XCHAR* FileName,   /*文件名或目录名的指针 */

  FILINFO* FileInfo        /* FILINFO结构的指针 */

);

参数

FileName'\0'结尾的字符串指针，该字符串指定了待获取其信息的文件或目录。

FileInfo存储信息的空白FILINFO结构的指针。

返回值

 

描述

f_stat函数当_FS_MINIMIZE == 0时可用。
f_stat函数获取一个文件或目录的信息。信息的详情，请参考FILINFO结构和f_readdir函数。

 

 

13）f_mkdir

创建一个目录

FRESULT f_mkdir (

  const XCHAR* DirName /*目录名的指针 */

);

参数

DirName'\0'结尾的字符串指针，该字符串指定了待创建的目录名。

返回值

 

14）f_unlink

移除一个对象

FRESULT f_unlink (

  const XCHAR* FileName  /*对象名的指针 */

);

参数

FileName'\0'结尾的字符串指针，该字符串指定了一个待移除的对象。

返回值

描述

f_unlink函数当_FS_READONLY == 0并且_FS_MINIMIZE == 0时可用。
f_unlink函数移除一个对象。不要移除打开的对象或当前目录。

 

15） f_chmod

修改一个文件或目录的属性。

FRESULT f_chmod (

  const XCHAR* FileName, /*文件或目录的指针 */

  BYTE Attribute,        /*属性标志 */

  BYTE AttributeMask     /*属性掩码 */

);

参数

FileName'\0'结尾的字符串指针，该字符串指定了一个待被修改属性的文件或目录。

Attribute待被设置的属性标志，可以是下列标志的一个或任意组合。指定的标志被设置，其他的被清除。

AttributeMask属性掩码，指定修改哪个属性。指定的属性被设置或清除。

返回值

 

描述

f_chmod函数当_FS_READONLY == 0并且_FS_MINIMIZE == 0时可用。
f_chmod函数修改一个文件或目录的属性。

例子

    // 设置只读标志，清除存档标志，其他不变

    f_chmod("file.txt", AR_RDO, AR_RDO | AR_ARC);

 

 

16） f_utime

f_utime函数修改一个文件或目录的时间戳。

FRESULT f_utime (

  const XCHAR* FileName,   /*文件或目录路径的指针 */

  const FILINFO* TimeDate  /*待设置的时间和日期 */

);

参数

FileName'\0'结尾的字符串的指针，该字符串指定了一个待修改时间戳的文件或目录。

TimeDate文件信息结构指针，其中成员ftime和fdata存储了一个待被设置的的时间戳。不关心任何其他成员。

返回值

 

 

描述

f_utime函数当_FS_READONLY == 0并且_FS_MINIMIZE == 0时可用。
f_utime函数修改一个文件或目录的时间戳。

 

17） f_rename

重命名一个对象。

FRESULT f_rename (

  const XCHAR* OldName, /*原对象名的指针 */

  const XCHAR* NewName  /*新对象名的指针 */

);

参数

OldName'\0'结尾的字符串的指针，该字符串指定了待被重命名的原对象名。

NewName'\0'结尾的字符串的指针，该字符串指定了重命名后的新对象名，不能包含驱动器号。

返回值

描述

f_rename函数当_FS_READONLY == 0并且_FS_MINIMIZE == 0时可用。
f_rename函数重命名一个对象，并且也可以将对象移动到其他目录。逻辑驱动器号由原名决定，新名不能包含一个逻辑驱动器号。不要重命名打开的对象。

例子

    /* 重命名一个对象 */

    f_rename("oldname.txt", "newname.txt");

 

    /* 重命名并且移动一个对象到另一个目录 */

    f_rename("oldname.txt", "dir1/newname.txt");

 

18）f_mkfs

在驱动器上创建一个文件系统

FRESULT f_mkfs (

  BYTE  Drive,            /*逻辑驱动器号 */

  BYTE  PartitioningRule, /*分区规则 */

  WORD  AllocSize         /*分配单元大小 */

);

参数

Drive待格式化的逻辑驱动器号(0-9)。

PartitioningRule当给定0时，首先在驱动器上的第一个扇区创建一个分区表，然后文件系统被创建在分区上。这被称为FDISK格式化，用于硬盘和存储卡。当给定1时，文件系统从第一个扇区开始创建，而没有分区表。这被称为超级软盘(SFD)格式化，用于软盘和可移动磁盘。

AllocSize指定每簇中以字节为单位的分配单元大小。数值必须是0或从512到32K之间2的幂。当指定0时，簇大小取决于卷大小。

返回值

描述

f_mkfs函数当_FS_READOLNY == 0并且_USE_MKFS == 1时可用。
f_mkfs函数在驱动器中创建一个FAT文件系统。对于可移动媒介，有两种分区规则：FDISK和SFD，通过参数PartitioningRule选择。FDISK格式在大多数情况下被推荐使用。该函数当前不支持多分区，因此，物理驱动器上已存在的分区将被删除，并且重新创建一个占据全部磁盘空间的新分区。
根据Microsoft发布的FAT规范，FAT分类：FAT12/FAT16/FAT32，由驱动器上的簇数决定。因此，选择哪种FAT分类，取决于卷大小和指定的簇大小。簇大小影响文件系统的性能，并且大簇会提高性能。

 

19） f_forward

读取文件数据并将其转发到数据流设备。

FRESULT f_forward (

  FIL* FileObject,                 /*文件对象 */

  UINT (*Func)(const BYTE*,UINT),  /*数据流函数 */

  UINT ByteToFwd,                  /*要转发的字节数 */

  UINT* ByteFwd                    /*已转发的字节数 */

);

参数

FileObject打开的文件对象的指针。

Func用户定义的数据流函数的指针。详情参考示例代码。

ByteToFwd要转发的字节数，UINT范围内。

ByteFwd返回已转发的字节数的UINT变量的指针。

返回值

 

 

 

20） f_chdir

f_chdir函数改变一个驱动器的当前目录。

FRESULT f_chdir (

  const XCHAR* Path /*路径名的指针 */

);

参数

Path'\0'结尾的字符串的指针，该字符串指定了将要进去的目录。

返回值

 

 

描述

f_chdir函数当_FS_RPATH == 1时可用。
f_chdir函数改变一个逻辑驱动器的当前目录。当一个逻辑驱动器被自动挂载时，它的当前目录被初始化为根目录。注意：当前目录被保存在每个文件系统对象中，因此它也影响使用同一逻辑驱动器的其它任务。

例子

    // 改变当前驱动器的当前目录(根目录下的dir1)

    f_chdir("/dir1");

    // 改变驱动器2的当前目录(父目录)

    f_chdir("2:..");

 

21）f_chdrive

f_chdrive函数改变当前驱动器。

FRESULT f_chdrive (

  BYTE Drive /*逻辑驱动器号 */

);

Drive指定将被设置为当前驱动器的逻辑驱动器号。

返回值

FR_OK (0)函数成功。

FR_INVALID_DRIVE驱动器号无效。

描述

f_chdrive函数当_FS_RPATH == 1时可用。
f_chdrive函数改变当前驱动器。当前驱动器号初始值为0，注意：当前驱动器被保存为一个静态变量，因此它也影响使用文件函数的其它任务。

 

22）f_gets

f_gets从文件中读取一个字符串。

char* f_gets (

  char* Str,        /*读缓冲区 */

  int Size,         /*读缓冲区大小 */

  FIL* FileObject   /*文件对象 */

);

参数

Str存储读取字符串的读缓冲区指针。

Size读缓冲区大小。

FileObject打开的文件对象结构指针。

返回值当函数成功后，Str将被返回。

描述

f_gets函数当_USE_STRFUNC == 1或者_USE_STRFUNC == 2时可用。如果_USE_STRFUNC == 2，文件中包含的'\r'则被去除。
f_gets函数是f_read的一个封装函数。当读取到'\n'、文件结束或缓冲区被填冲了Size - 1个字符时，读操作结束。读取的字符串以'\0'结束。当文件结束或读操作中发生了任何错误，f_gets()返回一个空字符串。可以使用宏f_eof()和f_error()检查EOF和错误状态。

 

23）f_putc

f_putc函数向文件中写入一个字符。

int f_putc (

  int Chr,          /*字符 */

  FIL* FileObject   /*文件对象 */

);

参数

Chr待写入的字符。

FileObject打开的文件对象结构的指针。

返回值

当字符被成功地写入后，函数返回该字符。由于磁盘满或任何错误而导致函数失败，将返回EOF。

描述

f_putc函数当(_FS_READONLY == 0)&&(_USE_STRFUNC == 1 || _USE_STRFUNC == 2)时可用。当_USE_STRFUNC == 2时，字符'\n'被转换为"\r\n"写入文件中。
f_putc函数是f_write的一个封装函数。

 

24） f_puts

f_puts函数向文件中写入一个字符串。

int f_puts (

  const char* Str,  /*字符串指针 */

  FIL* FileObject   /*文件对象指针 */

);

参数

Str待写入的'\0'结尾的字符串的指针。'\0'字符不会被写入。

FileObject打开的文件对象结构的指针。

返回值

函数成功后，将返回写入的字符数。由于磁盘满或任何错误而导致函数失败，将返回EOF。

描述

f_puts()当(_FS_READONLY == 0)&&(_USE_STRFUNC == 1 || _USE_STRFUNC == 2)时可用。当_USE_STRFUNC == 2时，字符串中的'\n'被转换为"\r\n"写入文件中。
f_puts()是f_putc()的一个封装函数。

 

 

25）f_printf

f_printf函数向文件中写入一个格式化字符串。

int f_printf (

  FIL* FileObject,     /*文件对象指针 */

  const char* Foramt,  /*格式化字符串指针 */

  ...

);

参数

FileObject已打开的文件对象结构的指针。

Format'\0'结尾的格式化字符串指针。

...

可选参数

返回值

函数成功后，将返回写入的字符数。由于磁盘满或任何错误而导致函数失败，将返回EOF。

描述

f_printf函数当(_FS_READONLY == 0)&&(_USE_STRFUNC == 1 || _USE_STRFUNC == 2)时可用。当_USE_STRFUNC == 2时，包含在格式化字符串中的'\n'将被转换成"\r\n"写入文件中。

f_printf函数是f_putc和f_puts的一个封装函数。如下所示，格式控制符是标准库的一个子集：
类型：c s d u X
大小：l
标志：0

例子

 f_printf(&fil, "%6d", -200);         /* "  -200" */

    f_printf(&fil, "%02u", 5);           /* "05" */

    f_printf(&fil, "%ld", 12345678L);    /* "12345678" */

    f_printf(&fil, "%08lX", 1194684UL);  /* "00123ABC" */

    f_printf(&fil, "%s", "String");      /* "String" */

    f_printf(&fil, "%c", 'a');           /* "a" */