iter_swap(std::counted_iterator)
From cppreference.com
< cpp | iterator | counted 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::counted_iterator
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
iter_swap
(C++20)
template< std::indirectly_swappable <I> I2 >
(since C++20)
friend constexpr void
iter_swap( const counted_iterator& x, const std::counted_iterator <I2>& y )
Swaps the objects pointed to by two underlying iterators. The behavior is undefined if either x.count() or y.count() is equal to 0.
The function body is equivalent to: ranges::iter_swap (x.base(), y.base());.
This function template is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when std::counted_iterator <I> is an associated class of the arguments.
[edit] Parameters
x, y
-
iterator adaptors to the elements to swap
[edit] Return value
(none)
[edit] Complexity
Constant.
[edit] Example
Run this code
#include <iostream> #include <iterator> #include <list> #include <vector> int main() { std::vector p{1, 2, 3, 4}, q{5, 6, 7, 8}; std::counted_iterator <std::vector <int>::iterator> ip{p.begin(), 2}; std::counted_iterator <std::vector <int>::iterator> iq{q.begin(), 3}; std::cout << *ip << ' ' << *iq << '\n'; iter_swap(ip, iq); // ADL std::cout << *ip << ' ' << *iq << '\n'; std::list x{0, 1, 3}; std::counted_iterator <std::list <int>::iterator> ix{x.begin(), 2}; // iter_swap(ip, ix); // error: not indirectly swappable }
Output:
1 5 5 1
[edit] See also
(C++20)
(customization point object)[edit]