Difference between revisions of "cpp/iterator/reverse iterator/iter swap"
From cppreference.com
< cpp | iterator | reverse iterator
m (→Example: expose iterators' type) |
({{source}} -> {{c multi}}.) |
||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{title | | + | {{title|iter_swap(std::reverse_iterator)}} |
{{cpp/iterator/reverse_iterator/navbar}} | {{cpp/iterator/reverse_iterator/navbar}} | ||
| − | {{ | + | {{|since=c++20| |
| − | + | ||
template< std::indirectly_swappable<Iter> Iter2 > | template< std::indirectly_swappable<Iter> Iter2 > | ||
| − | + | friend constexpr void iter_swap( const reverse_iterator& x, | |
| − | + | const std::reverse_iterator<Iter2>& y ) | |
| − | + | noexcept(/* see below */); | |
}} | }} | ||
| − | |||
| − | Swaps the objects pointed to by two adjusted underlying iterators. | + | Swaps the objects pointed to by two adjusted underlying iterators. |
| − | {{ | + | {{|auto tmp_x =x.base();auto tmp_y =y.base();ranges::iter_swap(--tmp_x, --tmp_y); |
| − | auto tmp_x = x.base(); | + | |
| − | auto tmp_y = y.base(); | + | }} |
| − | ranges::iter_swap(--tmp_x, --tmp_y); | + | |
| − | }} | + | |
===Parameters=== | ===Parameters=== | ||
{{par begin}} | {{par begin}} | ||
| − | {{par | x, y | reverse iterators to the elements to swap}} | + | {{par|x, y|reverse iterators to the elements to swap}} |
{{par end}} | {{par end}} | ||
| − | |||
| − | |||
| − | |||
===Complexity=== | ===Complexity=== | ||
| − | + | ||
| − | === | + | ====== |
| − | + | {{noexcept| | |
| − | + | std::is_nothrow_copy_constructible_v<Iter> && | |
| − | + | std::is_nothrow_copy_constructible_v<Iter2> && | |
| − | + | noexcept(ranges::iter_swap(--std::declval<Iter&>(), --std::declval<Iter2&>())) | |
| − | 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=== | ===Example=== | ||
| − | {{example | + | {{example |
| + | |code= | ||
#include <iostream> | #include <iostream> | ||
#include <iterator> | #include <iterator> | ||
| Line 48: | Line 39: | ||
int main() | int main() | ||
{ | { | ||
| − | std::vector v {1, 2, 3}; | + | std::vector v{1, 2, 3}; |
| − | std::list | + | std::list l{4, 5, 6}; |
| − | + | ||
| − | std::reverse_iterator<std::vector<int>::iterator> r1 { v.rbegin() }; | + | std::reverse_iterator<std::vector<int>::iterator> r1{v.rbegin()}; |
| − | std::reverse_iterator<std::list<int>::iterator> | + | std::reverse_iterator<std::list<int>::iterator> r2{l.rbegin()}; |
| − | + | ||
std::cout << *r1 << ' ' << *r2 << '\n'; | std::cout << *r1 << ' ' << *r2 << '\n'; | ||
| − | + | ||
| − | iter_swap(r1, r2); | + | iter_swap(r1, r2); |
| − | + | ||
std::cout << *r1 << ' ' << *r2 << '\n'; | std::cout << *r1 << ' ' << *r2 << '\n'; | ||
} | } | ||
| − | | output= | + | |output= |
3 6 | 3 6 | ||
6 3 | 6 3 | ||
| Line 67: | Line 58: | ||
===See also=== | ===See also=== | ||
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc inc | cpp/algorithm/dsc swap}} | + | {{dsc inc|cpp/algorithm/dsc swap}} |
| − | {{dsc inc | cpp/algorithm/dsc swap_ranges}} | + | {{dsc inc|cpp/algorithm/dsc swap_ranges}} |
| − | {{dsc inc | cpp/algorithm/dsc iter_swap}} | + | {{dsc inc|cpp/algorithm/dsc iter_swap}} |
| − | {{dsc inc | cpp/iterator/ranges/dsc iter_swap}} | + | {{dsc inc|cpp/iterator/ranges/dsc iter_swap}} |
| − | {{dsc inc | cpp/iterator/adaptor/dsc iter_swap | move_iterator}} | + | {{dsc inc|cpp/iterator/adaptor/dsc iter_swap|move_iterator}} |
{{dsc end}} | {{dsc end}} | ||
{{langlinks|de|es|fr|it|ja|pt|ru|zh}} | {{langlinks|de|es|fr|it|ja|pt|ru|zh}} | ||
Latest revision as of 23:29, 4 November 2024
| template< std::indirectly_swappable<Iter> Iter2 > friend constexpr void iter_swap( const reverse_iterator& x, |
(since C++20) | |
Swaps the objects pointed to by two adjusted underlying iterators.
Equivalent to auto tmp_x = x.base();
auto tmp_y = y.base();
ranges::iter_swap(--tmp_x, --tmp_y);.
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.
Contents |
[edit] Parameters
| x, y | - | reverse iterators to the elements to swap |
[edit] Complexity
Constant.
[edit] Exceptions
noexcept specification:
noexcept(
std::is_nothrow_copy_constructible_v<Iter> &&
std::is_nothrow_copy_constructible_v<Iter2> &&
noexcept(ranges::iter_swap(--std::declval<Iter&>(), --std::declval<Iter2&>()))
[edit] 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}; std::reverse_iterator<std::vector<int>::iterator> r1{v.rbegin()}; std::reverse_iterator<std::list<int>::iterator> r2{l.rbegin()}; std::cout << *r1 << ' ' << *r2 << '\n'; iter_swap(r1, r2); // ADL std::cout << *r1 << ' ' << *r2 << '\n'; }
Output:
3 6 6 3
[edit] 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) |
