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

履歴 編集

function
<filesystem>

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

    namespace std::filesystem {
      path current_path();                                            // (1)
      path current_path(std::error_code& ec);                         // (2)

      void current_path(const path& p);                               // (3)
      void current_path(const path& p, std::error_code& ec) noexcept; // (4)
    }

## 概要

現在の作業ディレクトリを取得・設定する。現在の作業ディレクトリとは、自身のプロセスに関するディレクトリであり、自身からの相対パスを解決する開始位置である。

- (1), (2) : 現在の作業ディレクトリを取得する
- (3), (4) : 現在の作業ディレクトリを設定する

## 効果

- (3), (4) : パス`p`を、現在の作業ディレクトリとして設定する
  - POSIX環境では、`chdir()`関数を使用する

## 戻り値

- (1), (2) : 現在の作業ディレクトリの絶対パスを、ネイティブフォーマットとして返す
  - POSIX環境では、`getcwd()`関数を使用する
  - エラーが発生した場合、 (2) では`path()`が返る
- (3), (4) : なし

## 例外

- (1), (3) : ファイルシステムがエラーを報告する場合がある。それに加えて、指定されたファイルが存在しない場合もエラーである。エラーが発生した場合は、`std::filesystem::filesystem_error` 例外を送出する
- (2) : 仕様上は未規定だが、パスのメモリ確保で例外が発生する可能性がある
- (4) : 投げない

## 備考

- この関数名は、単一のディレクトリ名ではなくパスが返る、ということを強調することを意図して命名された
- 多くのOSでは、現在の作業ディレクトリは、危険なグローバル変数である。サードパーティライブラリやシステムライブラリ、あるいは別のスレッドによって、予期せず変更される可能性がある

## 例

    #include <iostream>
    #include <filesystem>

    namespace fs = std::filesystem;

    int main()
    {
      // 現在の作業ディレクトリを取得
      fs::path p = fs::current_path();
      std::cout << p << std::endl;

      // 現在の作業ディレクトリを設定
      fs::current_path("/");
      std::cout << fs::current_path() << std::endl;
    }

### 出力例

    "/home/my_app"
    "/"

## バージョン

### 言語

- C++17

### 処理系

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