Namespaces
Variants

iter_swap (std::counted_iterator)

From cppreference.net
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
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
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

Смотрите также

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