iter_move(std::move_iterator)
From cppreference.com
< cpp | iterator | move iterator
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Iterator library
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++23)(C++20)(C++20)
(deprecated in C++17)
(C++20)
(C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++14)
(C++11)
(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++23)
(C++23)
(C++23)
(C++23)
(C++23)
(C++11)(C++14)
(C++14)(C++14)
std::move_iterator
Member functions
Non-member functions
(until C++20)(C++20)
(C++20)
(C++20)
iter_move
(C++20)
(C++20)
(C++11)
friend constexpr std::iter_rvalue_reference_t <Iter>
iter_move( const std::move_iterator & i ) noexcept(/* see below */);
(since C++20)
iter_move( const std::move_iterator & i ) noexcept(/* see below */);
Casts the result of dereferencing the underlying iterator to its associated rvalue reference type.
Equivalent to return std::ranges::iter_move (i.base());.
This function template is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when std::move_iterator <Iter> is an associated class of the arguments.
[edit] Parameters
i
-
a source move iterator
[edit] Return value
An rvalue reference or a prvalue temporary.
[edit] Complexity
Constant.
[edit] Exceptions
noexcept specification:
noexcept(noexcept(ranges::iter_move (i.base())))
[edit] Example
Run this code
#include <iomanip> #include <iostream> #include <iterator> #include <string> #include <vector> void print(const auto& rem, const auto& v) { std::cout << rem << '[' << size(v) << "] { "; for (char comma[]{0, ' ', 0}; const auto& s : v) std::cout << comma << std::quoted (s), comma[0] = ','; std::cout << " }\n"; } int main() { std::vector <std::string > p{"Andromeda", "Cassiopeia", "Phoenix"}, q; print("p", p), print("q", q); using MI = std::move_iterator <std::vector <std::string >::iterator>; for (MI first{p.begin()}, last{p.end()}; first != last; ++first) q.emplace_back(/* ADL */ iter_move(first)); print("p", p), print("q", q); }
Possible output:
p[3] { "Andromeda", "Cassiopeia", "Phoenix" }
q[0] { }
p[3] { "", "", "" }
q[3] { "Andromeda", "Cassiopeia", "Phoenix" }[edit] See also
(C++20)
(customization point object)[edit]
(C++20)
(function) [edit]
(C++11)
(function template) [edit]
(C++11)
(function template) [edit]
(C++20)
(algorithm function object)[edit]