std::filesystem::relative

namespace std::filesystem {
  path relative(const path& p, std::error_code& ec);                   // (1)
  path relative(const path& p, const path& base = current_path());     // (2)
  path relative(const path& p, const path& base, std::error_code& ec); // (3)
}

概要

パスを現在の作業ディレクトリからの相対パスに変換する。

(1) : 現在の作業ディレクトリからパスpへの相対パスを構築する
(2), (3) : パスbaseからパスpへの相対パスを構築する

戻り値

(1) : return relative(p, current_path(), ec);
(2) : return weakly_canonical(p).lexically_relative(weakly_canonical(base));
(3) : return weakly_canonical(p, ec).lexically_relative(weakly_canonical(base, ec));

(1)と(3)でエラーが発生した場合、ecにエラー情報が書き込まれ、path()が返る。

例外

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

例

POSIXベースシステムでの例

#include <iostream>
#include <filesystem>

namespace fs = std::filesystem;

int main()
{
  // 現在の作業ディレクトリからの相対パスに変換する
  fs::path p1 = fs::relative("/a.txt");
  std::cout << p1 << std::endl;

  // 現在の作業ディレクトリからひとつ上の階層からの相対パスに変換する
  fs::path p2 = fs::relative("/a.txt", "../");
  std::cout << p2 << std::endl;
}

xxxxxxxxxx
 
#include <iostream>
#include <filesystem>
​
namespace fs = std::filesystem;
​
int main()
{
  // 現在の作業ディレクトリからの相対パスに変換する
  fs::path p1 = fs::relative("/a.txt");
  std::cout << p1 << std::endl;
​
  // 現在の作業ディレクトリからひとつ上の階層からの相対パスに変換する
  fs::path p2 = fs::relative("/a.txt", "../");
  std::cout << p2 << std::endl;
}
​

出力

"../../a.txt"
"../a.txt"

Class / Function / Type

Header file

Other / All

std::filesystem::relative

概要

戻り値

例外

例

POSIXベースシステムでの例

出力

バージョン

言語

処理系