iter_swap(std::move_iterator)
From cppreference.com
< cpp | iterator | move 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::move_iterator
Member functions
Non-member functions
(until C++20)(C++20)
(C++20)
(C++20)
(C++20)
iter_swap
(C++20)
(C++11)
template< std::indirectly_swappable <Iter> Iter2 >
(since C++20)
friend constexpr void iter_swap( const move_iterator& x,
const std::move_iterator <Iter2>& y )
Swaps the objects pointed to by two underlying iterators.
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::move_iterator <Iter> is an associated class of the arguments.
[edit] Parameters
x, y
-
move iterators to the elements to swap
[edit] Complexity
Constant.
[edit] Exceptions
noexcept specification:
noexcept(noexcept(ranges::iter_swap (x.base(), y.base())))
[edit] Example
Run this code
#include <iostream> #include <iterator> #include <string> #include <vector> int main() { std::vector <std::string > p{"AA", "EE"}, q{"ⱯⱯ", "ƎƎ"}; std::move_iterator <std::vector <std::string >::iterator> x = std::make_move_iterator (p.begin()), y = std::make_move_iterator (q.begin()); std::cout << *x << ' ' << *y << '\n'; iter_swap(x, y); // ADL std::cout << *x << ' ' << *y << '\n'; }
Output:
AA ⱯⱯ ⱯⱯ AA
[edit] See also
(C++20)
(customization point object)[edit]