【转载】FatFS f_open()函数详解

2024-09-02 23:48
文章标签 函数 详解 open 转载 fatfs

本文主要是介绍【转载】FatFS f_open()函数详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

f_open


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


FRESULT f_open (


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


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


 BYTE ModeFlags           /* 模式标志 */


);


参数


FileObject


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


FileName


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


ModeFlags


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


模式 描述


FA_READ 指定读访问对象。可以从文件中读取数据。


与FA_WRITE结合可以进行读写访问。


FA_WRITE 指定写访问对象。可以向文件中写入数据。


与FA_READ结合可以进行读写访问。


FA_OPEN_EXISTING 打开文件。如果文件不存在,则打开失败。(默认)


FA_OPEN_ALWAYS 如果文件存在,则打开;否则,创建一个新文件。


FA_CREATE_NEW 创建一个新文件。如果文件已存在,则创建失败。


FA_CREATE_ALWAYS 创建一个新文件。如果文件已存在,则它将被截断并覆盖。


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


返回值


FR_OK (0)


函数成功,该文件对象有效。


FR_NO_FILE


找不到该文件。


FR_NO_PATH


找不到该路径。


FR_INVALID_NAME


文件名无效。


FR_INVALID_DRIVE


驱动器号无效。


FR_EXIST


该文件已存在。


FR_DENIED


由于下列原因,所需的访问被拒绝:


以写模式打开一个只读文件。


由于存在一个同名的只读文件或目录,而导致文件无法被创建。


由于目录表或磁盘已满,而导致文件无法被创建。


FR_NOT_READY


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


FR_WRITE_PROTECTED


在存储介质被写保护的情况下,以写模式打开或创建文件对象。


FR_DISK_ERR


由于底层磁盘I/O接口函数中的一个错误,而导致该函数失败。


FR_INT_ERR


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


FR_NOT_ENABLED


逻辑驱动器没有工作区。


FR_NO_FILESYSTEM


磁盘上没有有效地FAT卷。


描述


如果函数成功,则创建一个文件对象。该文件对象被后续的读/写函数用来访问文件。如果想要关闭一个打开的文件对象,则使用f_close函数。如果不关闭修改后的文件,那么文件可能会崩溃。


在使用任何文件函数之前,必须使用f_mount函数为驱动器注册一个工作区。只有这样,其他文件函数才能正常工作。


例子(文件拷贝)


void main (void)


{


   FATFS fs[2];         /* 逻辑驱动器的工作区(文件系统对象) */


   FIL fsrc, fdst;      /* 文件对象 */


   BYTE buffer[4096];   /* 文件拷贝缓冲区 */


   FRESULT res;         /* FatFs 函数公共结果代码 */


   UINT br, bw;         /* 文件读/写字节计数 */


   /* 为逻辑驱动器注册工作区 */


   f_mount(0, &fs[0]);


   f_mount(1, &fs[1]);


   /* 打开驱动器 1 上的源文件 */


   res = f_open(&fsrc, "1:srcfile.dat", FA_OPEN_EXISTING | FA_READ);


   if (res) die(res);


   /* 在驱动器 0 上创建目标文件 */


   res = f_open(&fdst, "0:dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE);


   if (res) die(res);


   /* 拷贝源文件到目标文件 */


   for (;;) {


       res = f_read(&fsrc, buffer, sizeof(buffer), &br);


       if (res || br == 0) break;   /* 文件结束错误 */


       res = f_write(&fdst, buffer, br, &bw);


       if (res || bw < br) break;   /* 磁盘满错误 */


   }


   /* 关闭打开的文件 */


   f_close(&fsrc);


   f_close(&fdst);


   /* 注销工作区(在废弃前) */


   f_mount(0, NULL);


   f_mount(1, NULL);


}

这篇关于【转载】FatFS f_open()函数详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1131422

相关文章

基于C++的UDP网络通信系统设计与实现详解

《基于C++的UDP网络通信系统设计与实现详解》在网络编程领域,UDP作为一种无连接的传输层协议,以其高效、低延迟的特性在实时性要求高的应用场景中占据重要地位,下面我们就来看看如何从零开始构建一个完整... 目录前言一、UDP服务器UdpServer.hpp1.1 基本框架设计1.2 初始化函数Init详解

springboot+redis实现订单过期(超时取消)功能的方法详解

《springboot+redis实现订单过期(超时取消)功能的方法详解》在SpringBoot中使用Redis实现订单过期(超时取消)功能,有多种成熟方案,本文为大家整理了几个详细方法,文中的示例代... 目录一、Redis键过期回调方案(推荐)1. 配置Redis监听器2. 监听键过期事件3. Redi

Springboot配置文件相关语法及读取方式详解

《Springboot配置文件相关语法及读取方式详解》本文主要介绍了SpringBoot中的两种配置文件形式,即.properties文件和.yml/.yaml文件,详细讲解了这两种文件的语法和读取方... 目录配置文件的形式语法1、key-value形式2、数组形式读取方式1、通过@value注解2、通过

Mybatis对MySQL if 函数的不支持问题解读

《Mybatis对MySQLif函数的不支持问题解读》接手项目后,为了实现多租户功能,引入了Mybatis-plus,发现之前运行正常的SQL语句报错,原因是Mybatis不支持MySQL的if函... 目录MyBATis对mysql if 函数的不支持问题描述经过查询网上搜索资料找到原因解决方案总结Myb

自定义注解SpringBoot防重复提交AOP方法详解

《自定义注解SpringBoot防重复提交AOP方法详解》该文章描述了一个防止重复提交的流程,通过HttpServletRequest对象获取请求信息,生成唯一标识,使用Redis分布式锁判断请求是否... 目录防重复提交流程引入依赖properties配置自定义注解切面Redis工具类controller

Python容器转换与共有函数举例详解

《Python容器转换与共有函数举例详解》Python容器是Python编程语言中非常基础且重要的概念,它们提供了数据的存储和组织方式,下面:本文主要介绍Python容器转换与共有函数的相关资料,... 目录python容器转换与共有函数详解一、容器类型概览二、容器类型转换1. 基本容器转换2. 高级转换示

HTML5的input标签的`type`属性值详解和代码示例

《HTML5的input标签的`type`属性值详解和代码示例》HTML5的`input`标签提供了多种`type`属性值,用于创建不同类型的输入控件,满足用户输入的多样化需求,从文本输入、密码输入、... 目录一、引言二、文本类输入类型2.1 text2.2 password2.3 textarea(严格

C++ move 的作用详解及陷阱最佳实践

《C++move的作用详解及陷阱最佳实践》文章详细介绍了C++中的`std::move`函数的作用,包括为什么需要它、它的本质、典型使用场景、以及一些常见陷阱和最佳实践,感兴趣的朋友跟随小编一起看... 目录C++ move 的作用详解一、一句话总结二、为什么需要 move?C++98/03 的痛点⚡C++

MySQL中between and的基本用法、范围查询示例详解

《MySQL中betweenand的基本用法、范围查询示例详解》BETWEENAND操作符在MySQL中用于选择在两个值之间的数据,包括边界值,它支持数值和日期类型,示例展示了如何使用BETWEEN... 目录一、between and语法二、使用示例2.1、betwphpeen and数值查询2.2、be

python中的flask_sqlalchemy的使用及示例详解

《python中的flask_sqlalchemy的使用及示例详解》文章主要介绍了在使用SQLAlchemy创建模型实例时,通过元类动态创建实例的方式,并说明了如何在实例化时执行__init__方法,... 目录@orm.reconstructorSQLAlchemy的回滚关联其他模型数据库基本操作将数据添