| | |
inlinenamespace/* unspecified */{
inlineconstexpr/* unspecified */ iter_move=/* unspecified */;
} | | (since C++20) (customization point object) |
Call signature | | |
template<class T>
requires/* see below */
constexpr decltype(auto) iter_move( T&& t)noexcept(/* see below */); | | (since C++20) |
| | |
Obtains an rvalue reference or a prvalue temporary from a given iterator.
Aranges::iter_move(t) isexpression-equivalent to:
- iter_move(t), ift has a class or enumeration type and the expression is well-formed when treated as anunevaluated operand, where theoverload resolution of
iter_move is performed only with the candidates found byargument-dependent lookup. - Otherwise,std::move(*t) if*t is well-formed and is an lvalue.
- Otherwise,*t if*t is well-formed and is an rvalue.
In all other cases, a call toranges::iter_move is ill-formed, which can result insubstitution failure whenranges::iter_move(e) appears in the immediate context of a template instantiation.
Ifranges::iter_move(e) is not equal to*e, the program is ill-formed, no diagnostic required.
Customization point objects
The nameranges::iter_move denotes acustomization point object, which is a constfunction object of aliteralsemiregular class type. SeeCustomizationPointObject for details.
[edit]Example
| This section is incomplete Reason: no example |
[edit]See also
| casts the result of dereferencing the adjusted underlying iterator to its associated rvalue reference type (function)[edit] |
| casts the result of dereferencing the underlying iterator to its associated rvalue reference type (function)[edit] |