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

Hey bestie 💖 welcome to the (3) manual page for std::move_i...+,+=,--,-,-=, straight outta the C++ Standard Libary (yes, that's the spelling in the header — we keep it iconic). This is the whole operator squad for std::move_iterator: operator++, +, +=, --, -, -=. Periodt.

🌟 NAME 🌟

std::move_iterator::operator++, +, +=, --, -, -= — and the page name says it again: std::move_iterator::operator++,+,+=,--,-,-=. It's giving operator family reunion and honestly? Obsessed. 🫶

🌀 Synopsis 🌀

Here's the synopsis, copied exactly — the column layout is doing its own little chaos dance, iykyk:

          move_iterator&           (until
          operator++();            C++17)
          constexpr                (since
          move_iterator&           C++17)
          operator++();
          move_iterator&                   (until
          operator--();                    C++17)
          constexpr                        (since
          move_iterator&                   C++17)
          operator--();
          move_iterator                            (until
          operator++( int                          C++17)
          );
          constexpr                                (since
          move_iterator                            C++17)
          operator++( int                          (until
          );                                       C++20)
          constexpr auto                           (since
          operator++( int                          C++20)
          );
          move_iterator                                    (until
          operator--( int                                  C++17)
          );
          constexpr
          move_iterator                                    (since
          operator--( int                                  C++17)
          );
          move_iterator
          operator+(                                               (until
          difference_type                                          C++17)
          n ) const;
          constexpr        (1)
          move_iterator                                            (since
          operator+(           (2)                                 C++17)
          difference_type
          n ) const;
          move_iterator            (3)
          operator-(
       (until
          difference_type
       C++17)
          n ) const;
          constexpr
          move_iterator                    (4)
       (since
          operator-(
       C++17)
          difference_type
          n ) const;                               (5)
          move_iterator&
          operator+=(
       (until
          difference_type
       C++17)
          n );
          constexpr                                        (6)
          move_iterator&
       (since
          operator+=(
       C++17)
          difference_type
          n );                                                     (7)
          move_iterator&
          operator-=(
       (until
          difference_type
       C++17)
          n );
          constexpr                                                       (8)
          move_iterator&
       (since
          operator-=(
       C++17)
          difference_type
          n );

So what does it all mean? Increments or decrements the iterator. That's the whole vibe check.

• 1,2) Pre-increments or pre-decrements by one respectively.
• 3,4) Post-increments or post-decrements by one respectively.
• 5,6) Returns an iterator which is advanced by n or -n positions respectively.
• 7,8) Advances the iterator by n or -n positions respectively.

🎀 Parameters 🎀

• n — position relative to current location

💖 Return value 💖

• 1,2) *this
• 3,4) A copy of *this that was made before the change; however, if Iter does not model forward_iterator, the post-increment operator does not return such copy and the return type is void (since C++20).
• 5,6) move_iterator(base()+n) or move_iterator(base()-n) respectively.
• 7,8) *this

🚧 Example 🚧

This section is incomplete.

Reason: no example

👀 See also 👀

• operator+ advances the iterator (C++11) (function template)
• operator- computes the distance between two iterator adaptors (C++11) (function template)

📌 Category 📌

• Todo no example

That's the tea 🍵 — source/version http://cppreference.com, date 2024.06.10, page std::move_i...+,+=,--,-,-=(3). Bye bestie, go increment something cute 💖✨