C++17 Filesystem 实用教程

 更新时间:2025年01月08日 08:35:09   作者:arong_xu  
C++17的std::filesystem库提供了强大的文件系统操作工具,本文就来介绍一下C++17 Filesystem 实用教程,具有一定的参考价值,感兴趣的可以了解一下

C++17 标准带来了 std::filesystem库, 提供了强大的工具来处理文件路径, 目录以及其他与文件系统相关的操作. 这篇文章适合 C++ 初学者以及希望掌握 C++17 新特性的开发者, 旨在帮助他们高效地完成文件系统相关任务.

什么是 std::filesystem?

std::filesystem 是 C++ 标准库的一部分, 位于 std::filesystem 名称空间中. 它提供了一个平台 独立的方式来与文件系统交互, 支持目录导航, 查询文件属性和实现文件操作等功能.

为什么使用 std::filesystem?

在 C++17 之前, 开发者依赖于平台特定的 API 或第三方库进行文件操作, 导致可移植性的挑战. 使用 std::filesystem, 您可以获得:

  • 跨平台支持: 为 Windows, Linux 和 macOS 提供统一的 API.
  • 便据性: 提供相关文件操作的直观函数.
  • 性能: 接口实现根据平台做了优化处理.

std::filesystem 常用功能

1. 检查文件和目录是否存在

#include <filesystem>
#include <iostream>

namespace fs = std::filesystem;

int main() {
  fs::path filePath = "example.txt";
  if (fs::exists(filePath)) {
    std::cout << "文件存在!\n";
  } else {
    std::cout << "文件不存在.\n";
  }
  return 0;
}

为了保持代码简洁, 后续代码中将不再包含头文件和main函数体, 读者可以从文末的源码链接获取完整源代码.

2. 创建和删除目录

fs::path dirPath = "new_directory";
fs::create_directory(dirPath);  // 创建单个目录
fs::remove(dirPath);            // 删除目录

3. 遍历目录

fs::path dirPath = "."; // 当前目录
for (const auto& entry : fs::recursive_directory_iterator(dirPath)) {
    std::cout << entry.path() << std::endl;
}

此示例会递归列出当前目录及其所有子目录中的文件和文件夹.

4. 查询文件属性

fs::path filePath = "example.txt";
if (fs::exists(filePath)) {
  std::cout << "文件大小: " << fs::file_size(filePath) << " 字节\n";
  std::cout << "是否为正解文件: " << fs::is_regular_file(filePath) << "\n";
  std::cout << "文件最后修改时间: "
            << fs::last_write_time(filePath).time_since_epoch().count()
            << "\n";
}

5. 复制和重命名文件

fs::copy("source.txt", "destination.txt", fs::copy_options::overwrite_existing); // 复制文件
fs::rename("old_name.txt", "new_name.txt"); // 重命名文件

6. 处理符号链接

fs::path symlinkPath = "symbolic_link";
fs::path targetPath = "target_file";
fs::create_symlink(targetPath, symlinkPath);  // 创建符号链接
if (fs::is_symlink(symlinkPath)) {
  std::cout << symlinkPath << " 是符号链接, 指向 "
            << fs::read_symlink(symlinkPath) << std::endl;
}

路径相关操作

7.1 路径组合

// 1. 路径组合
fs::path base = "/home/user/documents";
fs::path file = "report.pdf";
fs::path fullPath = base / file;  // 使用 / 操作符组合路径
std::cout << "组合路径: " << fullPath << std::endl;

输出

组合路径: "/home/user/documents/report.pdf"

7.2 获取路径组件

fs::path filepath = "/home/user/documents/report.pdf";
std::cout << "文件名: " << filepath.filename() << std::endl;
std::cout << "主文件名: " << filepath.stem() << std::endl;
std::cout << "扩展名: " << filepath.extension() << std::endl;
std::cout << "父路径: " << filepath.parent_path() << std::endl;

输出

文件名: "report.pdf"
主文件名: "report"
扩展名: ".pdf"
父路径: "/home/user/documents"

7.3 相对路径计算

fs::path p1 = "/home/user/documents";
fs::path p2 = "/home/user/pictures";
fs::path rel = fs::relative(p2, p1);  // 计算从 p1 到 p2 的相对路径
std::cout << "相对路径: " << rel << std::endl;  // ../pictures

输出

相对路径: "../pictures"

7.4 路径分解与迭代

fs::path complex = "/home/user/documents/work/report.pdf";
std::cout << "路径分解:" << std::endl;
for (const auto& part : complex) {
  std::cout << "  " << part << std::endl;
}

输出

路径分解:
  "/"
  "home"
  "user"
  "documents"
  "work"
  "report.pdf"

7.5 词法规范化路径

fs::path messy = "home/user/../user/./documents/report.pdf";
std::cout << "规范化路径: " << messy.lexically_normal() << std::endl;

输出

规范化路径: "home/user/documents/report.pdf"

7.6 路径比较

// 使用 std::filesystem::equivalent 检查两个路径是否指向同一文件
fs::path linkPath =
    "link_to_report.pdf";  // 假设这是一个指向 report.pdf 的符号链接
fs::path actualPath = "documents/report.pdf";
try {
  if (fs::equivalent(linkPath, actualPath)) {
    std::cout << "路径 " << linkPath << " 和 " << actualPath
              << " 指向同一文件." << std::endl;
  } else {
    std::cout << "路径 " << linkPath << " 和 " << actualPath
              << " 不指向同一文件." << std::endl;
  }
} catch (const fs::filesystem_error& e) {
  std::cerr << "文件系统错误: " << e.what() << std::endl;
}

7.7 路径拼接

fs::path prefix = "backup_";
fs::path filename = "report.pdf";
fs::path newPath = prefix.string() + filename.string();
std::cout << "拼接路径: " << newPath << std::endl;

输出

拼接路径: "backup_report.pdf"

7.8 检查路径特性

fs::path checkPath = "/home/user/documents/report.pdf";
std::cout << "是否为绝对路径: " << checkPath.is_absolute() << std::endl;
std::cout << "是否有扩展名: " << checkPath.has_extension() << std::endl;
std::cout << "是否有文件名: " << checkPath.has_filename() << std::endl;
std::cout << "是否有父路径: " << checkPath.has_parent_path() << std::endl;

输出

是否为绝对路径: 1
是否有扩展名: 1
是否有文件名: 1
是否有父路径: 1

路径替换操作

fs::path modPath = "/home/user/documents/report.pdf";
modPath.replace_filename("newreport.doc");
std::cout << "替换文件名后: " << modPath << std::endl;
modPath.replace_extension(".txt");
std::cout << "替换扩展名后: " << modPath << std::endl;

输出

替换文件名后: "/home/user/documents/newreport.doc"
替换扩展名后: "/home/user/documents/newreport.txt"

注意事项:

  • 路径操作是纯字符串操作, 不涉及实际文件系统
  • 这些操作在 Windows 和 Unix 系统上都能正常工作
  • 使用 / 操作符组合路径比直接字符串拼接更安全
  • lexically_normal() 可以清理路径中的 . 和 ..

最佳实践

  • 错误处理:

    • 使用异常处理来捕获和管理错误情况. 许多 std::filesystem 函数会抛出 std::filesystem::filesystem_error, 例如在没有删除权限时.
  • 路径类型:

    • 使用 fs::absolute 将相对路径转换为绝对路径, 以确保路径的完整性和清晰性.
  • 性能优化:

    • 对于网络磁盘或涉及大量文件的操作, 尽量减少 I/O 操作以提高性能.
  • 跨平台注意事项:

    • 路径格式: 虽然 std::filesystem 自动处理不同平台的路径分隔符差异(Windows 使用 \, 其他平台使用 /), 但建议始终使用 fs::path 进行路径操作.
    • 文件权限: 不同平台的文件权限管理可能不一致, 尤其是 fs::permissions.
  • 路径组合:

    • 使用 / 操作符组合路径比直接字符串拼接更安全.
  • 路径规范化:

    • 使用 lexically_normal() 清理路径中的 . 和 .., 以获得更简洁的路径表示.

限制性

  • 调用链接文件: 包含链接文件的操作在不同平台上有不同表现.
  • 性能: 尽管高效, 部分文件系统操作在网络磁盘上仍会突出慢.

结论

std::filesystem 库是 C++ 重要的增加, 使文件和目录操作更加简单和可移植. 无论您是在写一个简单脚本, 还是构建复杂应用, 熟练该库都是值得一试的.

开始探索 std::filesystem, 你将发现它是你 C++ 程序装备中一个珍贵的工具!

到此这篇关于C++17 Filesystem 实用教程的文章就介绍到这了,更多相关C++17 Filesystem内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:

相关文章

  • C++利用用埃式筛法求解素数

    C++利用用埃式筛法求解素数

    埃拉托斯特尼筛法,简称埃氏筛或爱氏筛,是一种由希腊数学家埃拉托斯特尼所提出的一种简单检定素数的算法。本文将利用这一算法实现求解素数,感兴趣的可以了解一下
    2023-01-01
  • C++教程之变量的作用域与生命周期详解

    C++教程之变量的作用域与生命周期详解

    在C++编程中,变量的作用域和生命周期是非常重要的概念。了解这些概念可以帮助开发人员编写更好的代码并避免错误。在本文中,我们将探讨C++中变量的作用域和生命周期,以及如何正确地使用它们
    2023-04-04
  • C++中的六个函数

    C++中的六个函数

    本文给大家介绍了C++中的六个函数,非常不错,具有一定的参考借鉴价值,需要的朋友参考下吧
    2018-05-05
  • C++使用LibCurl实现Web隐藏目录扫描功能

    C++使用LibCurl实现Web隐藏目录扫描功能

    LibCurl是一个开源的免费的多协议数据传输开源库,该框架具备跨平台性,开源免费,并提供了包括HTTP、FTP、SMTP、POP3等协议的功能,本文将给大家介绍C++使用LibCurl实现Web隐藏目录扫描功能
    2023-11-11
  • 函数式宏定义与普通函数的区别

    函数式宏定义与普通函数的区别

    尽管函数式宏定义和普通函数相比有很多缺点,但只要小心使用还是会显著提高代码的执行效率,毕竟省去了分配和释放栈帧、传参、传返回值等一系列工作,因此那些简短并且被频繁调用的函数经常用函数式宏定义来代替实现
    2013-10-10
  • C/C++ 中extern关键字详解

    C/C++ 中extern关键字详解

    这篇文章主要介绍了C/C++ 中extern关键字详解的相关资料,需要的朋友可以参考下
    2017-06-06
  • 浅谈C++11中的几种锁

    浅谈C++11中的几种锁

    本文主要介绍了C++11中的几种锁,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-01-01
  • 浅谈C++中char型变量的地址输出

    浅谈C++中char型变量的地址输出

    下面小编就为大家带来一篇浅谈C++中char 型变量的地址输出。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-09-09
  • C语言算法的定义及分析详解

    C语言算法的定义及分析详解

    这篇文章主要为大家详细介绍了C语言算法的定义及分析,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-09-09
  • C++实现双向链表

    C++实现双向链表

    这篇文章主要为大家详细介绍了C++实现双向链表,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-05-05

最新评论