std::filesystem::read_symlink
提供: cppreference.com
< cpp | filesystem
| ヘッダ <filesystem> で定義
|
||
| std::filesystem::path read_symlink(const std::filesystem::path& p); std::filesystem::path read_symlink(const std::filesystem::path& p, |
(C++17以上) | |
パス p がシンボリックリンクを参照している場合、そのシンボリックリンクのターゲットを参照する新しいパスオブジェクトを返します。
p がシンボリックリンクを参照していない場合はエラーです。
例外を投げないオーバーロードは、エラーが発生した場合、空のパスを返します。
目次 |
[編集] 引数
| p | - | シンボリックリンクを指すパス |
| ec | - | 例外を投げないオーバーロードでエラーを報告するための出力引数 |
[編集] 戻り値
シンボリックリンクのターゲット (存在しているとは限りません)。
[編集] 例外
std::error_code& 引数を取らないオーバーロードは、ベースとなる OS の API でエラーが発生した場合、第1パス引数に p、エラーコード引数に OS のエラーコードを指定して構築された filesystem_error を投げます。 std::error_code& 引数を取るオーバーロードは、 OS の API 呼び出しが失敗した場合、その引数を OS の API のエラーコードに設定し、エラーが発生しない場合は ec.clear() を実行します。 noexcept 指定のないあらゆるオーバーロードは、メモリ確保に失敗した場合 std::bad_alloc を投げる可能性があります。
[編集] 例
Run this code
#include <iostream> #include <filesystem> namespace fs = std::filesystem; int main() { // on a typical Linux system, /lib/libc.so.6 is a symlink fs::path p = "/lib/libc.so.6"; if(fs::exists(p) && fs::is_symlink(p)) std::cout << p << " -> " << fs::read_symlink(p) << '\n'; else std::cout << p << " does not exist or is not a symlink\n"; }
出力例:
"/lib/libc.so.6" -> "libc-2.12.so"
[編集] 関連項目
| (C++17) |
指定されたパスがシンボリックリンクを参照しているかどうか調べます (関数) |
| (C++17)(C++17) |
シンボリックリンクを作成します (関数) |
| (C++17) |
シンボリックリンクをコピーします (関数) |
| (C++17)(C++17) |
ファイルの属性を調べます シンボリックリンクのターゲットを確認しながらファイルの属性を調べます (関数) |
