std::iter_move(std::reverse_iterator) - cppreference.com (original) (raw)

Casts the result of dereferencing the adjusted underlying iterator to its associated rvalue reference type.

Equivalent to auto tmp = i.base();
return std::ranges::iter_move(--tmp);.

This function template is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when std::reverse_iterator<Iter> is an associated class of the arguments.

[edit] Parameters

[edit] Return value

An rvalue reference or a prvalue temporary.

[edit] Complexity

Constant.

[edit] Exceptions

[edit] Example

#include #include #include #include #include   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{"Alpha", "Bravo", "Charlie"}, q;   print("p", p), print("q", q);   using RI = std::reverse_iterator<std::vector<std::string>::iterator>;   for (RI iter{p.rbegin()}, rend{p.rend()}; iter != rend; ++iter) q.emplace_back(/* ADL */ iter_move(iter));   print("p", p), print("q", q); }

Possible output:

p[3] { "Alpha", "Bravo", "Charlie" } q[0] { } p[3] { "", "", "" } q[3] { "Charlie", "Bravo", "Alpha" }

[edit] See also