std::filesystem::rename
来自 cppreference.cn
< cpp | filesystem
定义于头文件 <filesystem> |
||
void rename( const std::filesystem::path& old_p, const std::filesystem::path& new_p ); |
(1) | (C++17 起) |
void rename( const std::filesystem::path& old_p, const std::filesystem::path& new_p, |
(2) | (C++17 起) |
将由 old_p 标识的文件系统对象移动或重命名为 new_p,如同通过 POSIX rename
函数。
- 如果 old_p 是一个非目录文件,则 new_p 必须是以下之一:
- 与 old_p 相同的文件或其硬链接:在这种情况下不执行任何操作。
- 已存在的非目录文件:new_p 首先被删除,然后,在不允许其他进程观察到 new_p 被删除的情况下,将路径名 new_p 链接到该文件,并将 old_p 从该文件取消链接。包含 old_p 的目录和包含 new_p 的目录都需要写权限。
- 现有目录中的不存在文件:路径名 new_p 链接到该文件,并将 old_p 从该文件取消链接。包含 old_p 的目录和包含 new_p 的目录都需要写权限。
- 如果 old_p 是一个目录,则 new_p 必须是以下之一:
- 与 old_p 相同的目录或其硬链接:在这种情况下不执行任何操作。
- 已存在的目录:在 POSIX 系统上,如果 new_p 为空,则将其删除,但这在其他系统上可能会出错。如果不是错误,则 new_p 首先被删除,然后,在不允许其他进程观察到 new_p 被删除的情况下,将路径名 new_p 链接到该目录,并将 old_p 从该目录取消链接。包含 old_p 的目录和包含 new_p 的目录都需要写权限。
- 不存在的目录,不以目录分隔符结尾,且其父目录存在:路径名 new_p 链接到该目录,并将 old_p 从该目录取消链接。包含 old_p 的目录和包含 new_p 的目录都需要写权限。
- 不跟随符号链接:如果 old_p 是一个符号链接,则重命名的是它本身,而不是其目标。如果 new_p 是一个已存在的符号链接,则删除的是它本身,而不是其目标。
重命名失败,如果
- new_p 以 dot 或 dot-dot 结尾。
- new_p 命名了一个不存在且以目录分隔符结尾的目录。
- old_p 是 new_p 的祖先目录。
目录 |
[编辑] 参数
old_p | - | 要移动或重命名的路径 |
new_p | - | 移动/重命名操作的目标路径 |
ec | - | 非抛出重载中用于错误报告的出参 |
[编辑] 返回值
(无)
[编辑] 异常
任何未标记为 noexcept
的重载都可能在内存分配失败时抛出 std::bad_alloc。
1) 在底层操作系统 API 错误时抛出 std::filesystem::filesystem_error,构造时以 old_p 作为第一个路径参数,new_p 作为第二个路径参数,操作系统错误代码作为错误代码参数。
[编辑] 示例
运行此代码
#include <filesystem> #include <fstream> namespace fs = std::filesystem; int main() { std::filesystem::path p = std::filesystem::current_path() / "sandbox"; std::filesystem::create_directories(p / "from"); std::ofstream{ p / "from/file1.txt" }.put('a'); std::filesystem::create_directory(p / "to"); // fs::rename(p / "from/file1.txt", p / "to/"); // error: "to" is a directory fs::rename(p / "from/file1.txt", p / "to/file2.txt"); // OK // fs::rename(p / "from", p / "to"); // error: "to" is not empty fs::rename(p / "from", p / "to/subdir"); // OK std::filesystem::remove_all(p); }
[编辑] 参阅
重命名文件 (函数) | |
(C++17)(C++17) |
删除文件或空目录 删除文件或目录及其所有内容,递归进行 (函数) |