std::filesystem::recursive_directory_iterator::operator++, std::filesystem::recursive_directory_iterator::increment
提供: cppreference.com
recursive_directory_iterator& operator++(); | (C++17以上) | |
recursive_directory_iterator& increment(std::error_code& ec ); | (C++17以上) | |
イテレータを次のエントリに進めます。 *this の以前の値のコピーをすべて無効化します。
現在イテレート中のディレクトリにこれ以上エントリが残っていなければ、親ディレクトリのイテレーションを再開します。 親ディレクトリにもイテレートできる兄弟エントリがなければ、それが繰り返されます。 再帰イテレートしているディレクトリ階層の親に達した場合 (depth()==0) において候補エントリがなくなった場合)、 *this は終端イテレータに設定されます。
そうでなく、 *this がディレクトリを参照している場合、以下の条件を満たせば、そのディレクトリの中にイテレートしていきます。
- このインクリメントの前に disable_recursion_pending() が呼ばれていない。 すなわち recursion_pending()==true である。
- ディレクトリがシンボリックリンクでないか、シンボリックリンクの辿りが有効化されている。 すなわち以下のいずれかまたは両方が真である。
- !is_symlink((*this)->symlink_status())
- (options()& directory_options::follow_directory_symlink)!= directory_options::none)
目次 |
[編集]引数
| ec | - | エラーを報告するための出力引数 |
[編集]戻り値
*this。
[編集]例外
std::error_code& 引数を取らないオーバーロードは、ベースとなる OS の API でエラーが発生した場合、エラーコード引数に 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 |
