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

履歴 編集

function
<filesystem>

# std::filesystem::copy_symlink(C++17)

    namespace std::filesystem {
      void copy_symlink(const path& existing_symlink, const path& new_symlink); // (1)
      void copy_symlink(const path& existing_symlink, const path& new_symlink,
                        std::error_code& ec) noexcept;                          // (2)
    }

## 概要

シンボリックリンクをコピーする。

パス`existing_symlink`にあるファイル・ディレクトリへのシンボリックリンクが指すパスへのシンボリックリンクを、`new_symlink`に作成する。

## 効果

- パス`existing_sumlink`がシンボリックリンクに解決され、
  - それが非ディレクトリへのシンボリックリンクであれば、
    - (1) : `create_symlink(read_symlink(existing_symlink), new_symlink)`と等価の処理をする
    - (2) : `create_symlink(read_symlink(existing_symlink, ec), new_symlink, ec)`と等価の処理をする
  - ディレクトリへのシンボリックリンクであれば、
    - (1) : `create_directory_symlink(read_symlink(existing_symlink), new_symlink)`と等価の処理をする
    - (2) : `create_directory_symlink(read_symlink(existing_symlink, ec), new_symlink, ec)`と等価の処理をする
- シンボリックリンク以外のファイルの場合はエラー

## 例外

- (1) : ファイルシステムがエラーを報告する場合がある。パス`existing_symlink`がシンボリックリンクに解決されない場合もエラーである。エラーが発生した場合は、`std::filesystem::filesystem_error` 例外を送出する
- (2) : 投げない

## 例

    #include <cassert>
    #include <filesystem>
    #include <fstream>

    namespace fs = std::filesystem;

    int main()
    {
      std::ofstream{"regular.txt"};
      fs::create_symlink("regular.txt", "regular.symlink");

      fs::copy_symlink("regular.symlink", "copied.symlink");

      assert(fs::exists("regular.symlink"));
      assert(fs::exists("copied.symlink"));

      assert(fs::read_symlink("regular.symlink") == "regular.txt");
      assert(fs::read_symlink("copied.symlink") == "regular.txt");
    }

### 出力

## バージョン

### 言語

- C++17

### 処理系

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