std::filesystem::relative, std::filesystem::proximate
提供: cppreference.com
< cpp | filesystem
| ヘッダ <filesystem> で定義
|
||
| path relative( const std::filesystem::path& p, std::error_code& ec); |
(1) | (C++17以上) |
| path relative( const std::filesystem::path& p, const std::filesystem::path& base = std::filesystem::current_path()); |
(2) | (C++17以上) |
| path proximate( const std::filesystem::path& p, std::error_code& ec); |
(3) | (C++17以上) |
| path proximate( const std::filesystem::path& p, const std::filesystem::path& base = std::filesystem::current_path()); |
(4) | (C++17以上) |
1) relative(p, current_path(), ec) を返します。
2)
base に対して相対化された p を返します。 他の処理を行う前に、 p と base の両方について、シンボリックリンクを解決し、正規化します。 実質的にweakly_canonical(p).lexically_relative(weakly_canonical(base)) または weakly_canonical(p, ec).lexically_relative(weakly_canonical(base, ec)) を返します。 ただしエラーコード形式では最初にエラーが発生したときに path() を返します。3) proximate(p, current_path(), ec) を返します。
4) 実質的に weakly_canonical(p).lexically_proximate(weakly_canonical(base)) または weakly_canonical(p, ec).lexically_proximate(weakly_canonical(base, ec)) を返します。 ただしエラーコード形式では最初にエラーが発生したときに path() を返します。
目次 |
[編集] 引数
| p | - | 存在するパス |
| base | - | p を相対化/近接化するための基準パス
|
| ec | - | エラーを報告するための出力引数 |
[編集] 戻り値
1) base に対して相対化された p
2) base に対して近接化された p
[編集] 例外
std::error_code& 引数を取らないオーバーロードは、ベースとなる OS の API でエラーが発生した場合、第1パス引数に p、第2パス引数に base、エラーコード引数に OS のエラーコードを指定して構築された filesystem_error を投げます。 std::error_code& 引数を取るオーバーロードは、 OS の API 呼び出しが失敗した場合、その引数を OS の API のエラーコードに設定し、エラーが発生しない場合は ec.clear() を実行します。 noexcept 指定のないあらゆるオーバーロードは、メモリ確保に失敗した場合 std::bad_alloc を投げる可能性があります。
[編集] 例
| This section is incomplete Reason: no example |
[編集] 関連項目
| (C++17) |
パスを表します (クラス) |
| (C++17) |
絶対���スを組み立てます (関数) |
| (C++17) |
正規パスを組み立てます (関数) |
