friend constexpr std::iter_rvalue_reference_t<Iter> iter_move( const std::move_iterator& i ) noexcept(/* see below */); | (since C++20) |
Casts the result of dereferencing the underlying iterator to its associated rvalue reference type.
The function body is 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.
i | - | a source move iterator. |
An rvalue reference or a prvalue temporary.
Constant.
noexcept
specification: noexcept(noexcept(ranges::iter_move(i.base())))
#include <iomanip> #include <iostream> #include <iterator> #include <string> #include <vector> void print(auto const& rem, auto const& v) { std::cout << rem << "[" << size(v) << "] { "; for (int o{}; auto const& s : v) std::cout << (o++ == 0 ? "" : ", ") << quoted(s); 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" }
(C++20) | casts the result of dereferencing an object to its associated rvalue reference type (customization point object) |
(C++20) | casts the result of dereferencing the adjusted underlying iterator to its associated rvalue reference type (function) |
(C++11) | obtains an rvalue reference (function template) |
(C++11) | obtains an rvalue reference if the move constructor does not throw (function template) |
(C++11) | forwards a function argument (function template) |
(C++20) | moves a range of elements to a new location (niebloid) |
(C++20) | moves a range of elements to a new location in backwards order (niebloid) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/iterator/move_iterator/iter_move