C++17 引入了 <filesystem> 库，它提供了一组用于操作文件和路径的工具。这个库极大地简化了文件和目录的管理，使得在不同操作系统上进行文件操作更加方便和统一。以下是对 <filesystem> 库的详细介绍，包括其主要概念和函数。

1. 引入头文件

在使用 <filesystem> 库之前，需要包含相应的头文件：

#include <filesystem>

命名空间为 std::filesystem，通常可以通过 using namespace std::filesystem; 来简化代码。

2. 路径（Path）

路径是 <filesystem> 库的核心概念之一，表示文件或目录的位置。路径可以是绝对路径或相对路径。

创建路径

path p = "example.txt"; // 相对路径
path q = "/home/user/example.txt"; // 绝对路径

路径操作

• 拼接路径：使用 / 运算符或 concat 函数。

  path p = "folder";
  path q = p / "file.txt"; // folder/file.txt
  

• 获取路径信息：
  • p.string()：将路径转换为字符串。
  • p.c_str()：获取路径的 C 风格字符串。
  • p.filename()：获取路径的最后一部分（文件名或目录名）。
  • p.parent_path()：获取路径的父目录。
  • p.extension()：获取文件的扩展名。
  • p.stem()：获取文件名去掉扩展名的部分。

  path p = "/home/user/example.txt";
  cout << p.filename() << endl; // example.txt
  cout << p.parent_path() << endl; // /home/user
  cout << p.extension() << endl; // .txt
  cout << p.stem() << endl; // example
  

3. 文件操作

检查文件状态

• exists(path)：检查路径是否存在。

  if (exists("example.txt")) {
      cout << "File exists" << endl;
  }
  

• is_regular_file(path)：检查路径是否指向普通文件。
• is_directory(path)：检查路径是否指向目录。
• is_symlink(path)：检查路径是否为符号链接。
• file_size(path)：获取文件大小（以字节为单位）。

  if (is_regular_file("example.txt")) {
      cout << "File size: " << file_size("example.txt") << " bytes" << endl;
  }
  

创建和删除文件

• create_directory(path)：创建一个目录。
• create_directories(path)：创建多级目录。
• remove(path)：删除文件或目录。

  create_directory("testdir");
  create_directories("testdir/subdir");
  remove("testdir/subdir");
  remove("testdir");
  

复制和移动文件

• copy_file(from, to)：复制文件。
• rename(from, to)：重命名或移动文件。

  copy_file("source.txt", "destination.txt");
  rename("oldname.txt", "newname.txt");
  

4. 目录操作

遍历目录

• directory_iterator：用于遍历目录中的文件和子目录。

  for (const auto& entry : directory_iterator("testdir")) {
      cout << entry.path() << endl;
  }
  

获取目录内容

• directory_iterator 提供了多种成员函数：
  • path()：获取路径。
  • is_directory()：判断是否为目录。
  • is_regular_file()：判断是否为普通文件。

  for (const auto& entry : directory_iterator("testdir")) {
      if (entry.is_directory()) {
          cout << entry.path() << " is a directory" << endl;
      } else if (entry.is_regular_file()) {
          cout << entry.path() << " is a file" << endl;
      }
  }
  

5. 文件状态和权限

获取文件状态

• status(path)：获取文件的状态。
• permissions(path)：获取文件的权限。

  file_status status = status("example.txt");
  if (status.permissions() == perms::owner_read) {
      cout << "File is readable by owner" << endl;
  }
  

修改文件权限

• permissions(path, perms)：修改文件权限。

  permissions("example.txt", perms::owner_read | perms::owner_write);
  

6. 文件流与文件系统

<filesystem> 库与 C++ 的文件流（如 ifstream 和 ofstream）可以无缝配合。可以直接将 path 对象传递给文件流构造函数：

ifstream in("example.txt");
ofstream out("output.txt");

7. 错误处理

<filesystem> 库使用异常机制处理错误。如果操作失败，会抛出 filesystem_error 异常。可以通过 try-catch 块捕获并处理这些异常：

try {
    remove("nonexistent_file.txt");
} catch (const filesystem_error& e) {
    cerr << e.what() << endl;
}

8. 示例代码

以下是一个综合示例，展示了 <filesystem> 库的多种功能：

#include <iostream>
#include <filesystem>
using namespace std;
using namespace std::filesystem;

int main() {
    path p = "example.txt";
    if (!exists(p)) {
        ofstream out(p);
        out << "Hello, Filesystem!" << endl;
        out.close();
    }

    cout << "File size: " << file_size(p) << " bytes" << endl;

    path dir = "testdir";
    create_directory(dir);

    for (const auto& entry : directory_iterator(dir.parent_path())) {
        if (entry.is_directory()) {
            cout << entry.path() << " is a directory" << endl;
        }
    }

    copy_file(p, dir / p.filename());
    remove(p);

    return 0;
}

9. 总结

<filesystem> 库为 C++ 提供了一种现代且跨平台的方式来操作文件和目录。它简化了许多复杂的文件操作任务，并且与 C++ 的其他标准库无缝集成。通过掌握路径操作、文件操作、目录操作以及错误处理等核心功能，可以高效地处理文件和目录相关的任务。