【转载】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

相关文章

PHP轻松处理千万行数据的方法详解

《PHP轻松处理千万行数据的方法详解》说到处理大数据集,PHP通常不是第一个想到的语言,但如果你曾经需要处理数百万行数据而不让服务器崩溃或内存耗尽,你就会知道PHP用对了工具有多强大,下面小编就... 目录问题的本质php 中的数据流处理:为什么必不可少生成器:内存高效的迭代方式流量控制:避免系统过载一次性

MySQL的JDBC编程详解

《MySQL的JDBC编程详解》:本文主要介绍MySQL的JDBC编程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录前言一、前置知识1. 引入依赖2. 认识 url二、JDBC 操作流程1. JDBC 的写操作2. JDBC 的读操作总结前言本文介绍了mysq

Redis 的 SUBSCRIBE命令详解

《Redis的SUBSCRIBE命令详解》Redis的SUBSCRIBE命令用于订阅一个或多个频道,以便接收发送到这些频道的消息,本文给大家介绍Redis的SUBSCRIBE命令,感兴趣的朋友跟随... 目录基本语法工作原理示例消息格式相关命令python 示例Redis 的 SUBSCRIBE 命令用于订

使用Python批量将.ncm格式的音频文件转换为.mp3格式的实战详解

《使用Python批量将.ncm格式的音频文件转换为.mp3格式的实战详解》本文详细介绍了如何使用Python通过ncmdump工具批量将.ncm音频转换为.mp3的步骤,包括安装、配置ffmpeg环... 目录1. 前言2. 安装 ncmdump3. 实现 .ncm 转 .mp34. 执行过程5. 执行结

Python中 try / except / else / finally 异常处理方法详解

《Python中try/except/else/finally异常处理方法详解》:本文主要介绍Python中try/except/else/finally异常处理方法的相关资料,涵... 目录1. 基本结构2. 各部分的作用tryexceptelsefinally3. 执行流程总结4. 常见用法(1)多个e

C++统计函数执行时间的最佳实践

《C++统计函数执行时间的最佳实践》在软件开发过程中,性能分析是优化程序的重要环节,了解函数的执行时间分布对于识别性能瓶颈至关重要,本文将分享一个C++函数执行时间统计工具,希望对大家有所帮助... 目录前言工具特性核心设计1. 数据结构设计2. 单例模式管理器3. RAII自动计时使用方法基本用法高级用法

SpringBoot日志级别与日志分组详解

《SpringBoot日志级别与日志分组详解》文章介绍了日志级别(ALL至OFF)及其作用,说明SpringBoot默认日志级别为INFO,可通过application.properties调整全局或... 目录日志级别1、级别内容2、调整日志级别调整默认日志级别调整指定类的日志级别项目开发过程中,利用日志

Java中的抽象类与abstract 关键字使用详解

《Java中的抽象类与abstract关键字使用详解》:本文主要介绍Java中的抽象类与abstract关键字使用详解,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧... 目录一、抽象类的概念二、使用 abstract2.1 修饰类 => 抽象类2.2 修饰方法 => 抽象方法,没有

MySQL8 密码强度评估与配置详解

《MySQL8密码强度评估与配置详解》MySQL8默认启用密码强度插件,实施MEDIUM策略(长度8、含数字/字母/特殊字符),支持动态调整与配置文件设置,推荐使用STRONG策略并定期更新密码以提... 目录一、mysql 8 密码强度评估机制1.核心插件:validate_password2.密码策略级

从入门到精通详解Python虚拟环境完全指南

《从入门到精通详解Python虚拟环境完全指南》Python虚拟环境是一个独立的Python运行环境,它允许你为不同的项目创建隔离的Python环境,下面小编就来和大家详细介绍一下吧... 目录什么是python虚拟环境一、使用venv创建和管理虚拟环境1.1 创建虚拟环境1.2 激活虚拟环境1.3 验证虚