---
name: "std::move_iterator"
section: "3"
platform: "linux"
package: "gcc"
version: "16.2.1+r23+gd564253eb6c8-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/std::move_iterator"
---

# std::move\_iterator(3)

An iterator adaptor that yields an rvalue reference.

## NAME

std::move\_iterator\< \_Iterator \> - An iterator adaptor that yields an rvalue reference.

## SYNOPSIS

\#include \<iterator\>

### Public Types

using **difference\_type**\
 using **iterator\_concept**\
 using **iterator\_type**\
 using **pointer**\
 using **reference**\
 using **value\_type**\

### Public Member Functions

template\<typename \_Iter\> constexpr **move\_iterator** (const move\_iterator\< \_Iter \> &\_\_i)\
 constexpr **move\_iterator** (iterator\_type \_\_i)\
 constexpr iterator\_type **base** () &&\
 constexpr const iterator\_type & **base** () const &noexcept\
 constexpr reference **operator\*** () const\
 constexpr move\_iterator **operator+** (difference\_type \_\_n) const\
 constexpr move\_iterator & **operator++** ()\
 constexpr void **operator++** (int)\
 constexpr move\_iterator **operator++** (int)\
 constexpr move\_iterator & **operator+=** (difference\_type \_\_n)\
 constexpr move\_iterator **operator-** (difference\_type \_\_n) const\
 constexpr move\_iterator & **operator--** ()\
 constexpr move\_iterator **operator--** (int)\
 constexpr move\_iterator & **operator-=** (difference\_type \_\_n)\
 constexpr pointer **operator-\>** () const\
 template\<typename \_Iter\> constexpr move\_iterator & **operator=** (const move\_iterator\< \_Iter \> &\_\_i)\
 constexpr reference **operator\[\]** (difference\_type \_\_n) const\

### Friends

constexpr **iter\_rvalue\_reference\_t**\< \_Iterator \> **iter\_move** (const move\_iterator &\_\_i) noexcept(noexcept(ranges::iter\_move(\_\_i.\_M\_current)))\
 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)))\
 template\<sized\_sentinel\_for\< \_Iterator \> \_Sent\> constexpr iter\_difference\_t\< \_Iterator \> **operator-** (const move\_iterator &\_\_x, const **move\_sentinel**\< \_Sent \> &\_\_y)\
 template\<sized\_sentinel\_for\< \_Iterator \> \_Sent\> constexpr iter\_difference\_t\< \_Iterator \> **operator-** (const **move\_sentinel**\< \_Sent \> &\_\_x, const move\_iterator &\_\_y)\
 template\<sentinel\_for\< \_Iterator \> \_Sent\> constexpr bool **operator==** (const move\_iterator &\_\_x, const **move\_sentinel**\< \_Sent \> &\_\_y)\

## Detailed Description

### template\<typename \_Iterator\>

class std::move\_iterator\< \_Iterator \>"An iterator adaptor that yields an rvalue reference.

Class template move\_iterator is an iterator adapter with the same behavior as the underlying iterator except that its dereference operator implicitly converts the value returned by the underlying iterator's dereference operator to an rvalue reference. Some generic algorithms can be called with move iterators to replace copying with moving.

## Author

Generated automatically by Doxygen for libstdc++ from the source code.