std::filesystem::is_empty
提供: cppreference.com
< cpp | filesystem
| ヘッダ <filesystem> で定義
|
||
| bool is_empty( const std::filesystem::path& p ); bool is_empty( const std::filesystem::path& p, std::error_code& ec ); |
(C++17以上) | |
指定されたパスが空のファイルまたは空のディレクトリを参照しているかどうか調べます。
目次 |
[編集] 引数
| p | - | 調べるパス |
| ec | - | 例外を投げないオーバーロードでエラーを報告するための出力引数 |
[編集] 戻り値
p の表すファイルが空のファイルまたは空のディレクトリを参照する場合は true、そうでなければ false。 例外を投げないオーバーロードは、エラーが発生した場合 false を返します。
[編集] 例外
std::error_code& 引数を取らないオーバーロードは、ベースとなる OS の API でエラーが発生した場合、第1パス引数に p、エラーコード引数に OS のエラーコードを指定して構築された filesystem_error を投げます。 std::error_code& 引数を取るオーバーロードは、 OS の API 呼び出しが失敗した場合、その引数を OS の API のエラーコードに設定し、エラーが発生しない場合は ec.clear() を実行します。 noexcept 指定のないあらゆるオーバーロードは、メモリ確保に失敗した場合 std::bad_alloc を投げる可能性があります。
[編集] 欠陥報告
以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。
| DR | 適用先 | 発行時の動作 | 正しい動作 |
|---|---|---|---|
| LWG 3013 | C++17 | error_code overload marked noexcept but can allocate memory
|
noexcept removed |
[編集] 例
| This section is incomplete Reason: no example |
[編集] 関連項目
| (C++17)(C++17) |
ファイルの属性を調べます シンボリックリンクのターゲットを確認しながらファイルの属性を調べます (関数) |
| (C++17) |
パスが既存のファイルシステムオブジェクトを参照しているかどうか調べます (関数) |
