Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

iter_swap(ranges::adjacent_view::iterator)

Swaps the objects pointed to by two underlying arrays of iterators (denoted as current_).

Ranges
  • C++20
  • C++23
1 min readView on cppreference
NotebookLM
friend constexpr void iter_swap( const /*iterator*/& x, const /*iterator*/& y )
    noexcept( /*see below*/ )
        requires std::indirectly_swappable<ranges::iterator_t<Base>>;
(since C++23)

Swaps the objects pointed to by two underlying arrays of iterators (denoted as current_).

Equivalent to:

snippet.cpp
for (std::size_t i{}; i != N; ++i)
{
    std::ranges::iter_swap(x.current_[i], y.current_[i]);
}

The behavior is undefined if before the operation none of the iterators in x.current_ is equal to an iterator in y.current_.

This function is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when adjacent_view::iterator<Const> is an associated class of the arguments.

Parameters

x, y - iterators

Return value

(none)

Exceptions

noexcept specification:  
noexcept(std::ranges::iter_swap(declval<ranges::iterator_t<Base>>(),
                                declval<ranges::iterator_t<Base>>()))

See also

(C++20)
swaps the values referenced by two dereferenceable objects
(customization point object)
swaps the elements pointed to by two iterators
(function template)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.