iter_swap(std::counted_iterator)

template< std::indirectly_swappable<I> I2 >
    friend constexpr void
        iter_swap( const counted_iterator& x, const std::counted_iterator<I2>& y )
            noexcept(noexcept(ranges::iter_swap(x.base(), y.base())));

(с C++20)

Меняет местами объекты, на которые указывают два базовых итератора. Поведение является неопределённым, если любой из x.count() или y.count() равен 0.

Тело функции эквивалентно: ranges::iter_swap(x.base(), y.base());.

Этот шаблон функции не виден для обычного неквалифицированного или квалифицированного поиска и может быть найден только с помощью поиска, зависящего от аргументов, когда std::counted_iterator<I> является связанным классом аргументов.

Параметры

x, y

итераторы-адаптеры для элементов, которые нужно поменять местами

Возвращаемое значение

(нет)

Сложность

Постоянная.

Пример

#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
}

Вывод:

1 5
5 1

См. также

swap	меняет местами значения двух объектов (шаблон функции)
swap_ranges	меняет местами два диапазона элементов (шаблон функции)
iter_swap	меняет местами элементы, на которые указывают два итератора (шаблон функции)
iter_swap (C++20)	меняет местами значения, на которые ссылаются два объекты с возможностью обратной ссылки (объект точки настройки)
iter_move (C++20)	приведение результата обращении к базовому итератору к типу связанного ссылкой rvalue (функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/iterator/counted_iterator/iter_swap