Difference between revisions of "cpp/iterator/reverse iterator/iter swap"
From cppreference.com
< cpp | iterator | reverse iterator
m (~) |
({{source}} -> {{c multi}}.) |
||
(2 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | {{cpp/title | iter_swap | + | {{cpp/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); | + | |
− | }} | + | |
− | {{cpp/hidden friend|std::reverse_iterator<Iter>|tmpl=yes}} | + | {{cpp/hidden friend|std::reverse_iterator<Iter>|tmpl=yes}} |
===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=== | ||
− | Constant | + | Constant |
===Exceptions=== | ===Exceptions=== | ||
{{noexcept| | {{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&>())) | |
}} | }} | ||
===Example=== | ===Example=== | ||
− | {{example | + | {{example |
+ | |code= | ||
#include <iostream> | #include <iostream> | ||
#include <iterator> | #include <iterator> | ||
Line 47: | 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 66: | 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}} |