std::ranges...rator::base(3)

okay so bestie, pull up a seat 🫶 — this is std::ranges...rator::base(3) from the C++ Standard Library manual, and we’re about to make iterator internals make sense 💅✨

💖 NAME 💖

std::ranges::elements_view::iterator::base — std::ranges::elements_view::iterator::base

🌸 Synopsis 🌸

okay so there are two overloads, both iconic, both since C++20:

(1) (since C++20)

constexpr const ranges::iterator_t<Base>& base() const & noexcept;

(2) (since C++20)

constexpr ranges::iterator_t<Base> base() &&;

Returns the underlying iterator. underlying iterator is the main character here, fr fr 🌈

• 1) Returns a reference to the underlying iterator.
• 2) Move constructs the result from the underlying iterator.

✨ Parameters ✨

(none) — literally no parameters, she’s low-maintenance 💅

🎀 Return value 🎀

• 1) A reference to the underlying iterator.
• 1) An iterator move constructed from the underlying iterator. (yes bestie, the page labels both of them 1) — iconic typo energy, but that’s what it says 🙈)

🦋 Example 🦋

This section is incomplete

Reason: no example

no cap, there is literally no example here 😭

🔥 Defect reports 🔥

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

• DR: LWG 3533 — Applied to: C++20 — Behavior as published: the const& overload of base returns a copy of the underlying iterator — Correct behavior: returns a reference.
• DR: LWG 3593 — Applied to: C++20 — Behavior as published: the const& overload of base might not be noexcept — Correct behavior: made noexcept.

💅 Category 💅

Category: * Todo no example

---

mwah 💋 that’s the std::ranges...rator::base(3) tea — source: http://cppreference.com, version/date: 2024.06.10 🌸🎀