std::reverse_iterator<Iter>::iter_swap
From cppreference.com
< cpp | iterator | reverse iterator
Revision as of 14:28, 12 April 2021 by Space Mission (Talk | contribs)
| template< std::indirectly_swappable<Iter> Iter2> friend constexpr void |
(since C++20) | |
Swaps the objects pointed to by two adjusted underlying iterators. A call to this function is expression-equivalent to:
auto tmp_x = x.base(); auto tmp_y = y.base(); ranges::iter_swap(--tmp_x, --tmp_y);
Contents |
Parameters
| x, y | - | reverse iterators to the elements to swap |
Return value
(none)
Complexity
constant
Exception
The expression in noexcept is equivalent to:
std::is_nothrow_copy_constructible_v<Iter> &&
std::is_nothrow_copy_constructible_v<Iter2> &&
noexcept(ranges::iter_swap(--std::declval<Iter&>(), --std::declval<Iter2&>()))
Example
Run this code
#include <iostream> #include <iterator> #include <list> #include <vector> int main() { std::vector v {1, 2, 3}; std::list l {4, 5, 6}; auto r1 = v.rbegin(); auto r2 = l.rbegin(); std::cout << *r1 << ' ' << *r2 << '\n'; iter_swap(r1, r2); std::cout << *r1 << ' ' << *r2 << '\n'; }
Output:
3 6 6 3
See also
| swaps the values of two objects (function template) | |
| swaps two ranges of elements (function template) | |
| swaps the elements pointed to by two iterators (function template) | |
| (C++20) |
swaps the values referenced by two dereferenceable objects (customization point object) |
| (C++20) |
swaps the objects pointed to by two underlying iterators (function template) |
