最終更新日時(UTC): 2024年06月11日 13時45分38秒
Akira Takahashi が更新

履歴 編集

function
<filesystem>

# std::filesystem::directory_entry::replace_filename(C++17)

    void replace_filename(const path& p);                      // (1)
    void replace_filename(const path& p, std::error_code& ec); // (2)

## 概要

ファイル名を置き換える。

## 効果

`*this`が保持している`path`オブジェクトを`pathobject`として、

- (1) : 以下と等価の処理を行う：

      pathobject.replace_filename(p);
      refresh();

- (2) : 以下と等価の処理を行う：

      pathobject.replace_filename(p);
      refresh(ec);

## 例

    #include <iostream>
    #include <filesystem>
    #include <fstream>

    namespace fs = std::filesystem;

    int main()
    {
      fs::create_directory("dir");
      std::ofstream{"dir/a.txt"};
      std::ofstream{"dir/b.txt"};

      fs::directory_entry x{"dir/a.txt"};
      x.replace_filename("b.txt");

      std::cout << x.path() << std::endl;
    }

### 出力

    "dir/b.txt"

## バージョン

### 言語

- C++17

### 処理系

- Clang:
- GCC: 8.1 ✅
- Visual C++: