STD::MOVE_ITERATOR(3)

💖 NAME 💖

std::move_iterator< _Iterator > — bestie, it's an iterator adaptor that yields an rvalue reference. that's it, that's the whole vibe 🦋

---

✨ SYNOPSIS ✨

okay so first you gotta bring it in:

#include <iterator>

---

🌸 Public Types 🌸

• difference_type — using difference_type, the type that tells you how far apart two of these are 💫
• iterator_concept — using iterator_concept, the concept tag situation 🏷️
• iterator_type — using iterator_type, aka the underlying iterator type you wrapped up 🎀
• pointer — using pointer 🫶
• reference — using reference, and bestie, this one's the whole point of the class ✨
• value_type — using value_type 💜

---

🔥 Public Member Functions 🔥

one bullet per function, no skips, we keep every single one:

• template<typename _Iter> constexpr move_iterator (const move_iterator< _Iter > &__i) — copy-constructs from another move_iterator over a different _Iter 💅
• constexpr move_iterator (iterator_type __i) — constructs from an underlying iterator, iterator_type __i 🎀
• constexpr iterator_type base () && — hands you back the underlying iterator (rvalue-qualified version) 🌈
• constexpr const iterator_type & base () const &noexcept — hands you back the underlying iterator as a const ref, and it's noexcept ⭐
• constexpr reference operator* () const — dereference, and this is the iconic one, it gives you an rvalue reference 🔥
• constexpr move_iterator operator+ (difference_type __n) const — slide forward by __n ✨
• constexpr move_iterator & operator++ () — pre-increment, returns a ref 💫
• constexpr void operator++ (int) — post-increment returning void 👀
• constexpr move_iterator operator++ (int) — post-increment returning a move_iterator 🦋
• constexpr move_iterator & operator+= (difference_type __n) — add __n in place, ref back at ya 💖
• constexpr move_iterator operator- (difference_type __n) const — slide back by __n 🌸
• constexpr move_iterator & operator-- () — pre-decrement, ref again 🎀
• constexpr move_iterator operator-- (int) — post-decrement returning a move_iterator 💅
• constexpr move_iterator & operator-= (difference_type __n) — subtract __n in place 🫶
• constexpr pointer operator-> () const — the arrow, it's giving pointer 🏹
• template<typename _Iter> constexpr move_iterator & operator= (const move_iterator< _Iter > &__i) — assign from a move_iterator< _Iter > over a different _Iter ✨
• constexpr reference operator[] (difference_type __n) const — index it by __n, still yielding that rvalue reference 💜

---

👑 Friends 👑

• constexpr iter_rvalue_reference_t< _Iterator > iter_move (const move_iterator &__i) noexcept(noexcept(ranges::iter_move(__i._M_current))) — the iter_move bestie, with that exact noexcept clause 🔥
• template<indirectly_swappable< _Iterator > _Iter2> constexpr void iter_swap (const move_iterator &__x, const move_iterator< _Iter2 > &__y) noexcept(noexcept(ranges::iter_swap(__x._M_current, __y._M_current))) — swaps two of these, _Iter2 must be indirectly_swappable< _Iterator >, and yes the noexcept is spelled out 💫
• template<sized_sentinel_for< _Iterator > _Sent> constexpr iter_difference_t< _Iterator > operator- (const move_iterator &__x, const move_sentinel< _Sent > &__y) — iterator minus sentinel, gives you a difference 🌸
• template<sized_sentinel_for< _Iterator > _Sent> constexpr iter_difference_t< _Iterator > operator- (const move_sentinel< _Sent > &__x, const move_iterator &__y) — sentinel minus iterator, also a difference 🎀
• template<sentinel_for< _Iterator > _Sent> constexpr bool operator== (const move_iterator &__x, const move_sentinel< _Sent > &__y) — compare an iterator against a sentinel, returns bool ✅

---

Detailed Description ✨

template<typename _Iterator>
class std::move_iterator< _Iterator >

"An iterator adaptor that yields an rvalue reference.

okay so here's the tea, bestie ☕ — class template move_iterator is an iterator adapter. it has the same behavior as the underlying iterator, with one glow-up: its dereference operator implicitly converts the value returned by the underlying iterator's dereference operator into an rvalue reference. that's the whole personality 💅

and the payoff? some generic algorithms can be called with move iterators to replace copying with moving. no cap, that's free performance. 🔥

---

✍️ Author ✍️

Generated automatically by Doxygen for libstdc++ from the source code. 🤖 (not a human girlie wrote this one, it's a robot, but she ate fr fr)

---

💖 that's the whole page bestie, go forth and move instead of copy, ily 🫶

libstdc++ · std::move_..._Iterator >(3) — mwah, that's the version and the page number, stan libstdc++, periodt 💅✨🎀