stdmove_iterator(3)
std::move_iterator - std::move_iterator
Synopsis
Defined in header <iterator>
template< class Iter > (since C++11)
class move_iterator;std::move_iterator is an iterator adaptor which behaves exactly like the underlying iterator (which must be at least an LegacyInputIterator), except that dereferencing converts the value returned by the underlying iterator into an rvalue. If this iterator is used as an input iterator, the effect is that the values are moved from, rather than copied from.
Member types
Member type Definition iterator_type Iter difference_type std::iterator_traits<Iter>::difference_type pointer Iter value_type std::iterator_traits<Iter>::value_type iterator_category std::iterator_traits<Iter>::iterator_category
reference value_type&& (until C++17)
Member functions
operator*
operator-> accesses the pointed-to element
(deprecated in C++20)
operator++ operator++(int) operator+= advances or decrements the iterator operator+ (public member function) operator– operator–(int) operator-= operator-
Member objects
Member name Definition current (private) a copy of the base() iterator, the name is for exposition only
Non-member functions
operator==
operator!= compares the underlying iterators
operator< (function template)
operator<=
operator>
operator>=
Example
// Run this code
#include <iostream>
#include <algorithm>
#include <vector>
#include <iterator>
#include <numeric>
#include <string>
int main()
{
std::vector<std::string> v{"this", "is", "an", "example"};
std::cout << "Old contents of the vector: ";
for (auto &s : v)
std::cout << ‘"’ << s << "" ";
typedef std::vector<std::string>::iterator iter_t;
std::string concat = std::accumulate(
std::move_iterator<iter_t>(v.begin()),
std::move_iterator<iter_t>(v.end()),
std::string()); // Can be simplified with std::make_move_iterator
std::cout << "\nConcatenated as string: " << concat << ‘\n’
<< "New contents of the vector: ";
for (auto &s : v)
std::cout << ‘"’ << s << "" ";
std::cout << ‘\n’;
}
Possible output:
See also
make_move_iterator creates a std::move_iterator of type inferred from the argument