std::filesystem::recursive_directory_iterator::operator++, std::filesystem::recursive_directory_iterator::increment

イテレータを次のエントリに進めます。 *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)

引数

戻り値

*this。

例外

std::error_code& 引数を取らないオーバーロードは、ベースとなる OS の API でエラーが発生した場合、エラーコード引数に OS のエラーコードを指定して構築された filesystem_error を投げます。 std::error_code& 引数を取るオーバーロードは、 OS の API 呼び出しが失敗した場合、その引数を OS の API のエラーコードに設定し、エラーが発生しない場合は ec.clear() を実行します。 noexcept 指定のないあらゆるオーバーロードは、メモリ確保に失敗した場合 std::bad_alloc を投げる可能性があります。

欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。