fatfs::FatFsFileSystem::FatFsFileOps Class Reference

FatFS 文件操作实现 More...

#include <fatfs.hpp>

Inheritance diagram for fatfs::FatFsFileSystem::FatFsFileOps:

Collaboration diagram for fatfs::FatFsFileSystem::FatFsFileOps:

Public Member Functions
	FatFsFileOps (FatFsFileSystem *fs)
auto	Read (vfs::File *file, void *buf, size_t count) -> Expected< size_t > override
	从文件读取数据
auto	Write (vfs::File *file, const void *buf, size_t count) -> Expected< size_t > override
	向文件写入数据
auto	Seek (vfs::File *file, int64_t offset, vfs::SeekWhence whence) -> Expected< uint64_t > override
	移动文件读写位置
auto	Close (vfs::File *file) -> Expected< void > override
	关闭文件，释放底层 FIL 对象
auto	ReadDir (vfs::File *file, vfs::DirEntry *dirent, size_t count) -> Expected< size_t > override
	读取目录条目
Public Member Functions inherited from vfs::FileOps
	FileOps ()=default
	FileOps (const FileOps &)=delete
	FileOps (FileOps &&)=delete
auto	operator= (const FileOps &) -> FileOps &=delete
auto	operator= (FileOps &&) -> FileOps &=delete
virtual	~FileOps ()=default

Private Attributes
FatFsFileSystem *	fs_

Detailed Description

FatFS 文件操作实现

Definition at line 185 of file fatfs.hpp.

Constructor & Destructor Documentation

FatFsFileOps()

fatfs::FatFsFileSystem::FatFsFileOps::FatFsFileOps ( FatFsFileSystem *  fs )

inlineexplicit

Definition at line 187 of file fatfs.hpp.

: fs_(fs) {}

Member Function Documentation

Close()

auto fatfs::FatFsFileSystem::FatFsFileOps::Close ( vfs::File *  file ) -> Expected<void>

overridevirtual

关闭文件，释放底层 FIL 对象

Parameters

file

文件对象

Returns

Expected<void> 成功或错误

Implements vfs::FileOps.

Definition at line 458 of file fatfs.cpp.

                                                                       {
  auto* fi = static_cast<FatInode*>(file->inode->fs_private);
 
  // 如果有打开的 DIR，关闭并释放
  if (fi->dir != nullptr) {
    (void)f_closedir(fi->dir);
    fs_->FreeDir(fi->dir);
    fi->dir = nullptr;
  }
 
  // 关闭文件句柄（如果有）
  if (fi->fil == nullptr) {
    return {};
  }
  FRESULT fr = f_close(fi->fil);
  fs_->FreeFil(fi->fil);
  fi->fil = nullptr;
  return FresultToExpected(fr);
}

Read()

auto fatfs::FatFsFileSystem::FatFsFileOps::Read ( vfs::File *  file, void *  buf, size_t  count  ) -> Expected<size_t>

overridevirtual

从文件读取数据

Parameters

file	文件对象
buf	读取缓冲区
count	请求读取的字节数

Returns

Expected<size_t> 实际读取字节数或错误

Implements vfs::FileOps.

Definition at line 396 of file fatfs.cpp.

                                                                           {
  auto* fi = static_cast<FatInode*>(file->inode->fs_private);
  if (fi->fil == nullptr) {
    return std::unexpected(Error{ErrorCode::kFsInvalidFd});
  }
  UINT bytes_read = 0;
  FRESULT fr = f_read(fi->fil, buf, static_cast<UINT>(count), &bytes_read);
  if (fr != FR_OK) {
    klog::Err("FatFsFileOps::Read: f_read failed ({})", static_cast<int>(fr));
    return std::unexpected(Error{FresultToErrorCode(fr)});
  }
  file->offset += bytes_read;
  return static_cast<size_t>(bytes_read);
}

Here is the call graph for this function:

ReadDir()

auto fatfs::FatFsFileSystem::FatFsFileOps::ReadDir ( vfs::File *  file, vfs::DirEntry *  dirent, size_t  count  ) -> Expected<size_t>

overridevirtual

读取目录条目

Parameters

file	目录文件对象
dirent	输出缓冲区
count	最多读取的条目数

Returns

Expected<size_t> 实际读取条目数或错误

Implements vfs::FileOps.

Definition at line 478 of file fatfs.cpp.

                        {
  auto* fi = static_cast<FatInode*>(file->inode->fs_private);
 
  // 首次调用时惰性初始化 DIR（保持迭代状态）
  if (fi->dir == nullptr) {
    DIR* dir = fs_->AllocateDir();
    if (dir == nullptr) {
      return std::unexpected(Error{ErrorCode::kFsFdTableFull});
    }
    FRESULT fr = f_opendir(dir, fi->path.data());
    if (fr != FR_OK) {
      fs_->FreeDir(dir);
      return std::unexpected(Error{FresultToErrorCode(fr)});
    }
    fi->dir = dir;
  }
 
  size_t read_count = 0;
  for (size_t i = 0; i < count; ++i) {
    FILINFO fi_info;
    FRESULT fr = f_readdir(fi->dir, &fi_info);
    if (fr != FR_OK || fi_info.fname[0] == '\0') {
      break;
    }
    dirent[i].ino = 0;
    dirent[i].type = static_cast<uint8_t>((fi_info.fattrib & AM_DIR) != 0
                                              ? vfs::FileType::kDirectory
                                              : vfs::FileType::kRegular);
    strncpy(dirent[i].name, fi_info.fname, sizeof(dirent[i].name) - 1);
    dirent[i].name[sizeof(dirent[i].name) - 1] = '\0';
    ++read_count;
  }
  file->offset += static_cast<uint64_t>(read_count);
  return read_count;
}

Seek()

auto fatfs::FatFsFileSystem::FatFsFileOps::Seek ( vfs::File *  file, int64_t  offset, vfs::SeekWhence  whence  ) -> Expected<uint64_t>

overridevirtual

移动文件读写位置

Parameters

file	文件对象
offset	偏移量
whence	定位基准（kSet / kCur / kEnd）

Returns

Expected<uint64_t> 新的文件偏移量或错误

Implements vfs::FileOps.

Definition at line 429 of file fatfs.cpp.

                          {
  auto* fi = static_cast<FatInode*>(file->inode->fs_private);
  if (fi->fil == nullptr) {
    return std::unexpected(Error{ErrorCode::kFsInvalidFd});
  }
  FSIZE_t new_pos = 0;
  switch (whence) {
    case vfs::SeekWhence::kSet:
      new_pos = static_cast<FSIZE_t>(offset);
      break;
    case vfs::SeekWhence::kCur:
      new_pos =
          static_cast<FSIZE_t>(static_cast<int64_t>(f_tell(fi->fil)) + offset);
      break;
    case vfs::SeekWhence::kEnd:
      new_pos =
          static_cast<FSIZE_t>(static_cast<int64_t>(f_size(fi->fil)) + offset);
      break;
  }
  FRESULT fr = f_lseek(fi->fil, new_pos);
  if (fr != FR_OK) {
    return std::unexpected(Error{FresultToErrorCode(fr)});
  }
  file->offset = static_cast<uint64_t>(new_pos);
  return static_cast<uint64_t>(new_pos);
}

Write()

auto fatfs::FatFsFileSystem::FatFsFileOps::Write ( vfs::File *  file, const void *  buf, size_t  count  ) -> Expected<size_t>

overridevirtual

向文件写入数据

Parameters

file	文件对象
buf	写入数据缓冲区
count	请求写入的字节数

Returns

Expected<size_t> 实际写入字节数或错误

Implements vfs::FileOps.

Definition at line 412 of file fatfs.cpp.

                                                                            {
  auto* fi = static_cast<FatInode*>(file->inode->fs_private);
  if (fi->fil == nullptr) {
    return std::unexpected(Error{ErrorCode::kFsInvalidFd});
  }
  UINT bytes_written = 0;
  FRESULT fr = f_write(fi->fil, buf, static_cast<UINT>(count), &bytes_written);
  if (fr != FR_OK) {
    klog::Err("FatFsFileOps::Write: f_write failed ({})", static_cast<int>(fr));
    return std::unexpected(Error{FresultToErrorCode(fr)});
  }
  file->offset += bytes_written;
  file->inode->size = static_cast<uint64_t>(f_size(fi->fil));
  return static_cast<size_t>(bytes_written);
}

Here is the call graph for this function:

Member Data Documentation

fs_

FatFsFileSystem* fatfs::FatFsFileSystem::FatFsFileOps::fs_

private

Definition at line 237 of file fatfs.hpp.

---

The documentation for this class was generated from the following files:

• /workspaces/SimpleKernel/src/filesystem/fatfs/include/fatfs.hpp
• /workspaces/SimpleKernel/src/filesystem/fatfs/fatfs.cpp