文件操作函数

ゝ一世哀愁。 2022-12-27 01:15 578阅读 0赞

f\_open函数打开一个文件。 //  打开/创建文件

FRESULT f_open（
      FIL * fp，            / * [OUT]指向文件对象结构的指针* / 
      const TCHAR *路径，/ * [IN]文件名* / 
      BYTE模式          / * [IN]模式标志* /
    ）;

/ *打开一个文本文件* / 
    f_open（＆fil，“ message.txt”，FA_READ）；

[http://elm-chan.org/fsw/ff/doc/open.html][http_elm-chan.org_fsw_ff_doc_open.html]

f\_close函数关闭打开的文件。

FRESULT f_close（
      FIL * fp      / * [IN]指向文件对象的指针* /
    ）;

描述

该f\_close函数关闭一个打开的文件对象。如果文件已更改，则文件的缓存信息将写回到该卷。函数成功后，文件对象不再有效，可以将其丢弃。

f\_read函数从文件读取数据。

FRESULT f_read（
      FIL * fp，      / * [IN]文件对象* / 
      void * buff，   / * [OUT]存储读取数据的缓冲区* / 
      UINT btr，     / * [IN]读取的字节数* / 
      UINT * br      / * [ OUT]读取的字节数* /
    ）;

描述

该函数以读/写指针指向的文件偏移量开始从文件读取数据。读/写指针随着读取的字节数而增加。函数成功后，应检查\* br以检测文件结尾。如果\* br < btr，则意味着在读操作期间读/写指针到达文件的末尾。

f\_write将数据写入文件。

FRESULT f_write（
      FIL * fp，           / * [IN]指向文件对象结构的指针* / 
      const void * buff，/ * [IN]指向要写入的数据的指针* / 
      UINT btw，          / * [IN]要写入的字节数* / 
      UINT * bw           / * [OUT]指向变量的指针，以返回写入的字节数* /
    ）;

描述

该函数开始在读/写指针指向的文件偏移处将数据写入文件。读/写指针随着写入的字节数而增加。函数成功后，应检查\* bw以检测磁盘已满。如果\* bw < btw，则意味着在写操作期间该卷已满。

f_read(&fsrc, buffer, sizeof buffer, &br);  /* Read a chunk of data from the source file */
            if (br == 0) break; /* error or eof */
            f_write(&fdst, buffer, br, &bw);            /* Write it to the destination file */
            if (bw < br) break; /* error or disk full */

## f\_lseek ##

f\_lseek函数移动打开的文件对象的文件读/写指针。它也可以用来扩展文件大小（集群预分配）。

FRESULT f_lseek（
      FIL *     fp，   / * [IN]文件对象* / 
      FSIZE_t ofs   / * [IN]文件读/写指针* /
    ）;

FRESULT f_rewind（
      FIL *     fp，   / * [IN]文件对象* /
    ）;

解释：移动 读写指针。

描述：f\_lseek 有两个功能：

1. 移动文件对象的读写指针，可以在文件任何位置进行读写。

2. 扩展文件大小。如果在写入模式下指定的偏移量超出文件大小，则文件大小将扩展到指定的偏移量。扩展部分中的文件数据是*未定义的，*因为在此过程中没有数据写入该文件。扩展文件大小后，要进行check.

res = f_lseek(fp, PRE_SIZE);             /* Expand file size (cluster pre-allocation) */
    if (res || f_tell(fp) != PRE_SIZE) ...   /* Check if the file has been expanded successfly */

(f\_tell(fp) != PRE\_SIZE)如果读/写指针不是期望值，则发生以下两种情况之一。

*  文件末尾。由于文件已以只读模式打开，因此指定的ofs被剪切到文件末尾。
 *  磁盘已满。卷上没有可用空间来扩展文件。

附加：

可以启动快速查找
       启动步骤如下：
    
        DWORD clmt [SZ_TBL];                    / *集群链接映射表缓冲区* /
    
        res = f_open（fp，fname，FA_READ | FA_WRITE）;   / *打开文件* /
    
        res = f_lseek（fp，ofs1）;               / *这是正常查找（打开文件时cltbl为空）* /
    
        fp-> cltbl = clmt;                      / *启用快速查找模式（cltbl！= NULL）* / 
        clmt [0] = SZ_TBL;                      / *设置表大小* / 
        res = f_lseek（fp，CREATE_LINKMAP）;     / *创建CLMT * /
        ...
    
        res = f_lseek（fp，ofs2）;               / *这是快速查找* /

f\_truncate函数将截断文件大小。

FRESULT f_truncate（
      FIL * fp      / * [IN]文件对象* /
    ）;

描述

该f\_truncate功能截断文件大小为当前文件的读/写指针。如果文件读/写指针已经指向文件结尾，则此功能无效。

即：将此刻读写指针的位置作为文件尾部。

res = f\_truncate（fp）; / \*截断未使用的区域\* /

f\_expand 函数为文件准备或分配连续的数据区域。

FRESULT f_expand（
      FIL *     fp，   / * [IN]文件对象* / 
      FSIZE_t fsz，/ * [IN]文件大小扩展为* / 
      BYTE     opt   / * [IN]分配模式* /
    ）;

描述

连续文件在时间紧迫的读/写操作中具有优势。它消除了由于随机访问碎片文件而导致的文件系统和存储设备中的一些开销。

而且，可以通过低级磁盘功能直接轻松访问连续文件。但是，考虑到可移植性和将来的兼容性，建议不要这样做。

## f\_sync ##