命名空间
变体
操作

std::filesystem::directory_entry::replace_filename

来自 cppreference.com
 
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) 将 std::error_code& 参数设置为操作系统 API 错误代码（如果操作系统 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"