Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/iterator/reverse iterator/iter swap"

From cppreference.com
m (~)
({{source}} -> {{c multi}}.)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{cpp/title | iter_swap<small>(std::reverse_iterator)</small>}}
+
{{cpp/title|iter_swap(std::reverse_iterator)}}
 
{{cpp/iterator/reverse_iterator/navbar}}
 
{{cpp/iterator/reverse_iterator/navbar}}
{{dcl begin}}
+
{{|since=c++20|
{{dcl|since=c++20|
+
 
template< std::indirectly_swappable<Iter> Iter2 >
 
template< std::indirectly_swappable<Iter> Iter2 >
  friend constexpr void
+
friend constexpr void iter_swap( const reverse_iterator& x,
    iter_swap( const reverse_iterator& x,
+
const std::reverse_iterator<Iter2>& y )
              const std::reverse_iterator<Iter2>& y ) noexcept(/*see below*/);
+
noexcept(/* see below */);
 
}}
 
}}
{{dcl end}}
 
  
Swaps the objects pointed to by two adjusted underlying iterators. The function body is equivalent to:
+
Swaps the objects pointed to by two adjusted underlying iterators.
  
{{source|1=
+
{{|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}}
 
===Return value===
 
(none)
 
  
 
===Complexity===
 
===Complexity===
Constant
+
Constant
  
 
===Exceptions===
 
===Exceptions===
 
{{noexcept|
 
{{noexcept|
  std::is_nothrow_copy_constructible_v<Iter> &&
+
std::is_nothrow_copy_constructible_v<Iter> &&
  std::is_nothrow_copy_constructible_v<Iter2> &&
+
std::is_nothrow_copy_constructible_v<Iter2> &&
  noexcept(ranges::iter_swap(--std::declval<Iter&>(), --std::declval<Iter2&>()))
+
noexcept(ranges::iter_swap(--std::declval<Iter&>(), --std::declval<Iter2&>()))
 
}}
 
}}
  
 
===Example===
 
===Example===
{{example | | code=
+
{{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   l {4, 5, 6};
+
     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>   r2 { l.rbegin() };
+
     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}}

Latest revision as of 23:29, 4 November 2024

 
 
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors