std::basic_...++,--,+=,-=(3)

💖 NAME 💖

okay so bestie, welcome to the C++ Standard Libary manual (yes, “Libary” is the spelling from the source, we are not fixing it 💅). this page is std::basic_...++,--,+=,-=(3), and the main character is std::basic_const_iterator::operator++,--,+=,-=.

std::basic_const_iterator::operator++,--,+=,-= — that's the name. std::basic_const_iterator::operator++,--,+=,-= — yep, same name again. the source really said it twice and we're keeping the duplicate because every detail stays. periodt. 💖

🌸 Synopsis 🌸

here's the whole overload lineup, copied exactly so nobody comes for me:

          constexpr basic_const_iterator& operator++();                   (1)
       (since C++23)
          constexpr void operator++(int);                                 (2)
       (since C++23)
          constexpr basic_const_iterator operator++(int)                  (3)
       (since C++23)
              requires std::forward_iterator<Iter>;
          constexpr basic_const_iterator& operator--()                    (4)
       (since C++23)
              requires std::bidirectional_iterator<Iter>;
          constexpr basic_const_iterator operator--(int)                  (5)
       (since C++23)
              requires std::bidirectional_iterator<Iter>;
          constexpr basic_const_iterator& operator+=( difference_type n ) (6)
       (since C++23)
              requires std::random_access_iterator<Iter>;
          constexpr basic_const_iterator& operator-=( difference_type n ) (7)
       (since C++23)
              requires std::random_access_iterator<Iter>;

so yeah, every one of these is since C++23, and the requires clauses are doing their little gatekeeping thing. ✨

the actual vibe: these increment or decrement the iterator by applying the corresponding operation on the underlying iterator. no cap.

• 1–3 increment by one. 💅
• 4,5 decrement by one. 🦋
• 6,7 advance the iterator by n or -n positions respectively. 🔥

🎀 Return value 🎀

• 1,4,6,7 — *this
• 3,5 — a copy of *this that was made before the change
• 2 — (none)

🦋 Example 🦋

This section is incomplete. Reason: no example.

no example bestie 😭 it's giving “todo” energy. but we move.

🌈 See also 🌈

• operator++
• operator++(int)
• operator+=
• operator+ — advances or decrements the iterator
• operator-- — (public member function of std::move_iterator<Iter>)
• operator--(int)
• operator-=
• operator-
• (C++11)

💀 Category 💀

• Todo no example

mwah 💋 — source http://cppreference.com, version/date 2024.06.10, page std::basic_...++,--,+=,-=(3). bye bestie, go increment something 🫶