std::iter_move(std::reverse_iterator)
From cppreference.com
< cpp | iterator | reverse 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::reverse_iterator
iter_move
(C++20)
(C++20)
(C++14)
friend constexpr std::iter_rvalue_reference_t <Iter>
iter_move( const std::reverse_iterator & i ) noexcept(/* see below */);
(since C++20)
iter_move( const std::reverse_iterator & i ) noexcept(/* see below */);
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
i
-
a source reverse iterator
[edit] Return value
An rvalue reference or a prvalue temporary.
[edit] Complexity
Constant.
[edit] Exceptions
noexcept specification:
noexcept(
std::is_nothrow_copy_constructible_v <Iter> &&
noexcept(std::ranges::iter_move (--std::declval <Iter&>()))
[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{"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
(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]