命名空间
变体
操作

std::filesystem::directory_entry::replace_filename

来自 cppreference.cn
 
C++
 
文件系统库
类
函数
文件类型
 
std::filesystem::directory_entry
成员函数
修改器
directory_entry::replace_filename
观察器
(直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(C++20)
非成员函数
 
void replace_filename( const std::filesystem::path& p );
 (1) (C++17 起)
void replace_filename( const std::filesystem::path& p, std::error_code& ec );
 (2) (C++17 起)

修改目录项的文件名。

通过 path.replace_filename(p) 有效地修改路径成员，并调用 refresh 以更新缓存属性。如果发生错误，缓存属性的值将是不确定的。

此函数不会对文件系统提交任何更改。

目录

[编辑] 参数

p - 要附加到当前存储路径的父路径的路径
ec - 非抛出重载中用于错误报告的出参

[编辑] 返回值

(无)

[编辑] 异常

任何未标记为 noexcept 的重载都可能在内存分配失败时抛出 std::bad_alloc。

1) 在底层操作系统 API 错误时抛出 std::filesystem::filesystem_error，构造时以 p 作为第一个路径参数，操作系统错误码作为错误码参数。
2) 如果操作系统 API 调用失败，将 std::error_code& 参数设置为操作系统 API 错误码；如果没有发生错误，则执行 ec.clear()。

[编辑] 示例

运行此代码
#include <filesystem>
#include <iostream>
 
int main()
{
    namespace fs = std::filesystem;
    {
        fs::directory_entry entry{"alpha"};
        std::cout << entry << '\n';
        entry.replace_filename("omega");
        std::cout << entry << '\n';
    }
    {
        fs::directory_entry entry{"/alpha/"};
        std::cout << entry << '\n';
        entry.replace_filename("omega");
        std::cout << entry << '\n';
    }
}

输出

"alpha"
"omega"
"/alpha/"
"/alpha/omega"

[编辑] 参阅

 赋值内容
(公共成员函数) [编辑]
 用另一个路径替换最后一个路径组件
(std::filesystem::path 的公共成员函数) [编辑]
取自“https://cppreference.cn/mwiki/index.php?title=cpp/filesystem/directory_entry/replace_filename&oldid=158089”