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)

Меняет местами объекты, на которые указывают два базовых итератора.

Эквивалентно ranges::iter_swap(x.base(), y.base());.

Если x.count > 0 && y.count() > 0 равно false, поведение не определено.

(до C++26)

Если x.count > 0 && y.count() > 0 равно false:

Если реализация защищена от ошибок, происходит нарушение контракта.
Если реализация не защищена от ошибок, поведение не определено.

(начиная с C++26)

Этот шаблон функции не виден при обычном неквалифицированном поиске или квалифицированном поиске; его можно найти только с помощью поиска с учётом аргументов, если 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	меняет местами элементы двух диапазонов (шаблон функции и функциональный объект алгоритма)
ranges::swap_ranges (C++20)
iter_swap	меняет местами элементы, на которые указывают два итератора (шаблон функции)
ranges::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/cpp/iterator/counted_iterator/iter_swap