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

履歴 編集

function
<filesystem>

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

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

## 概要

ディレクトリに対するシンボリックリンクを作成する。

パス`to`のディレクトリに対するシンボリックリンクをパス`new_symlink`に作成する。

ファイルシステムによっては、ディレクトリに対するシンボリックリンクを`create_symlink()`関数で作成できない場合がある。より汎用的なプログラムを記述する場合に、この関数を使用する。

## 効果

- POSIX環境では、`symlink()`関数を使用して、パス`to`のディレクトリに対するシンボリックリンクをパス`new_symlink`に作成する
  - パス`to`は、パス`new_symlink`からの相対パスであることに注意

## 戻り値

なし

## 例外

- (1) : ファイルシステムがエラーを報告する場合がある。エラーが発生した場合は、`std::filesystem::filesystem_error` 例外を送出する
- (2) : 投げない

## 例

    #include <cassert>
    #include <filesystem>

    namespace fs = std::filesystem;

    int main()
    {
      fs::create_directory("dir");

      // dirに対するシンボリックリンクをdir_symlinkファイルとして作成する
      fs::create_directory_symlink("dir", "dir_symlink");

      assert(fs::exists("dir_symlink"));
      assert(fs::is_symlink("dir_symlink"));
    }

### 出力

## バージョン

### 言語

- C++17

### 処理系

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