std::ranges...w::iterator(3)

🌸 NAME 🌸

std::ranges::adjacent_view::iterator — std::ranges::adjacent_view::iterator. Yep bestie, the NAME section says it twice and we're keeping both, no erasure 💅. This page is std::ranges...w::iterator(3) from the C++ Standard Libary (that's the manual name, typo and all, and I said what I said).

✨ Synopsis ✨

template< bool Const >  (since C++23)
class /*iterator*/      (exposition only*)

Okay so this is the return type of adjacent_view::begin, and also of adjacent_view::end when the underlying view V is a common_range. Main character behavior fr fr.

The type /*iterator*/<true> is returned by the const-qualified overloads. The type /*iterator*/<false> is returned by the non-const-qualified overloads. Both versions are valid and iconic 🫶.

🎀 Member types 🎀

Here's the whole member-type lineup, no skipping:

• Base (private) — const V if Const is true, otherwise V. (exposition-only member type*)
• iterator_category — std::input_iterator_tag
  • std::random_access_iterator_tag, if Base models random_access_range. Otherwise,
• iterator_concept — std::bidirectional_iterator_tag, if Base models bidirectional_range. Otherwise,
  • std::forward_iterator_tag.
• value_type — std::tuple</*REPEAT*/(ranges::range_value_t<Base>, N)...>;
• difference_type — ranges::range_difference_t<Base>

💅 Data members 💅

• current_ (private) — std::array<ranges::iterator_t<Base>, N>. (exposition-only member object*)

🌈 Member functions 🌈

• constructor (C++23) — constructs an iterator (public member function)
• operator* (C++23) — accesses the element (public member function)
• operator[] (C++23) — accesses an element by index (public member function)
• operator++, operator++(int), operator--, operator--(int), operator+=, operator-= — advances or decrements the underlying iterators (public member function). The original drops a (C++23) marker right after operator-=, so that's here too 🫡.

🔥 Non-member functions 🔥

• operator==, operator<, operator>, operator<=, operator>= — compares the underlying iterators (function)
• operator<=> (C++23) — compares the underlying iterators (function)
• operator+, operator- (C++23) — performs iterator arithmetic (function)
• iter_move (C++23) — casts the result of dereferencing the underlying iterator to its associated rvalue reference type (function)
• iter_swap (C++23) — swaps the objects pointed to by two underlying iterators (function)

🦋 Example 🦋

This section is incomplete.

Reason: no example 😭

👑 References 👑

• C++23 standard (ISO/IEC 14882:2023):
• 26.7.25.3 Class template adjacent_view::iterator [range.adjacent.iterator]

🌸 See also 🌸

Category:

• Todo no example

And that's the whole page, bestie! Footer source/version and date: http://cppreference.com · 2024.06.10 · std::ranges...w::iterator(3). Mwah 💖