Rust FAT FS

使用 Rust 实现的 FAT 文件系统库。

功能

• 使用标准 Read/Write 特性读写文件
• 读取目录内容
• 创建/删除文件或目录
• 重命名/移动文件或目录
• 读取/写入文件时间戳（如果启用了 chrono 功能，则自动更新）
• 格式化卷
• FAT12, FAT16, FAT32 兼容性
• 支持 LFN（长文件名）扩展
• 基本 no_std 环境支持

使用方法

将此添加到您的 Cargo.toml

[dependencies]
fatfs = "0.3"

并添加到您的 crate 根目录

extern crate fatfs;

现在您可以使用 fatfs 库了

let img_file = File::open("fat.img")?;
let fs = fatfs::FileSystem::new(img_file, fatfs::FsOptions::new())?;
let root_dir = fs.root_dir();
let mut file = root_dir.create_file("hello.txt")?;
file.write_all(b"Hello World!")?;

注意：建议将底层文件结构封装在缓冲/缓存对象（如来自 fscommon crate 的 BufStream）中。例如

extern crate fscommon;
let buf_stream = BufStream::new(img_file);
let fs = fatfs::FileSystem::new(buf_stream, fatfs::FsOptions::new())?;

更多示例请参阅 examples 子目录。

no_std 使用

将此添加到您的 Cargo.toml

[dependencies]
fatfs = { version = "0.3", features = ["core_io"], default-features = false }

在 no_std 模式下构建需要与 core_io crate 兼容的 Rust 编译器版本。

目前 core_io 仅支持 nightly Rust 频道。请查看最新 core_io crate 版本中的日期后缀以获取确切的编译器版本。

其他功能

• alloc - 使用 alloc crate 进行动态分配。对于 LFN（长文件名）支持和使用 String 类型的 API，需要。您可能需要提供内存分配器实现。

注意：上述功能默认启用。

许可证

MIT 许可证。请参阅 LICENSE.txt。