std::filesy...erator::pop(3)

📦 version 2024.07.05, in nixpkgs unstable, opensuse-leap 16.0

💖 std::filesy...erator::pop(3) — C++ Standard Libary 💖

✨ NAME ✨

std::filesystem::recursive_directory_iterator::pop — okay bestie, this is the function, and the NAME field is literally the same name twice: std::filesystem::recursive_directory_iterator::pop - std::filesystem::recursive_directory_iterator::pop. We are in the C++ Standard Libary manual, and yes, that spelling is exactly what the page says. 🫶

📜 Synopsis 📜

void pop();                      (1) (since C++17)
void pop( std::error_code& ec ); (2) (since C++17)

Moves the iterator one level up in the directory hierarchy.

⚠️ Also: it invalidates all copies of the previous value of *this. Like, every copy, bestie. 💀

If the parent directory is outside directory hierarchy that is iterated on (i.e. depth() == 0), sets *this to an end directory iterator. 🌀

🧾 Parameters 🧾

  • ec — error code to store the error status to. 🌸

🔁 Return value 🔁

  • (none) — literally none. 💅

💥 Exceptions 💥

Any overload not marked noexcept may throw std::bad_alloc if memory allocation fails. 😭

  1. Throws std::filesystem::filesystem_error on underlying OS API errors, constructed with the OS error code as the error code argument.
  2. Sets a std::error_code& parameter to the OS API error code if an OS API call fails, and executes ec.clear() if no errors occur.

📝 Example 📝

This section is incomplete.

Reason: no example.

🏷️ Category: 🏷️

  • Todo no example

okay that's the whole page, bestie — source: http://cppreference.com, version/date: 2024.06.10, and the footer page is std::filesy...erator::pop(3) 🫶💖✨

📦 where this page comes from