std::iter_swap(std::reverse_iterator)

template< std::indirectly_swappable<Iter> Iter2 >
    friend constexpr void
        iter_swap( const reverse_iterator& x,
                   const std::reverse_iterator<Iter2>& y ) noexcept(/*see below*/);

(с C++20)

Меняет местами объекты, на которые указывают два изменённых базовых итератора. Тело функции эквивалентно:

auto tmp_x = x.base();
auto tmp_y = y.base();
ranges::iter_swap(--tmp_x, --tmp_y);

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

Параметры

x, y

обратные итераторы к элементам для обмена

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

(нет)

Сложность

Постоянная.

Исключения

noexcept спецификация:

noexcept(
 std::is_nothrow_copy_constructible_v<Iter> &&
 std::is_nothrow_copy_constructible_v<Iter2> &&
 noexcept(ranges::iter_swap(--std::declval<Iter&>(), --std::declval<Iter2&>()))

)

Пример

#include <iostream>
#include <iterator>
#include <list>
#include <vector>
 
int main()
{
    std::vector v{1, 2, 3};
    std::list l{4, 5, 6};
 
    std::reverse_iterator<std::vector<int>::iterator> r1{v.rbegin()};
    std::reverse_iterator<std::list<int>::iterator> r2{l.rbegin()};
 
    std::cout << *r1 << ' ' << *r2 << '\n';
 
    iter_swap(r1, r2); // ADL
 
    std::cout << *r1 << ' ' << *r2 << '\n';
}

Вывод:

3 6
6 3

См. также

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

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