Namensräume
Varianten
Aktionen

std::iter_swap(std::reverse_iterator)

Von cppreference.com
 
 
Iterator-Bibliothek
Iterator-Konzepte
Iterator-Primitive
Algorithmus-Konzepte und Hilfsprogramme
Indirekte aufrufbare Konzepte
Gemeinsame Algorithmus-Anforderungen
(C++20)
(C++20)
(C++20)
Dienstprogramme
(C++20)
Iterator-Adapter
Bereichszugriff
(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<Iter> Iter2 >

friend constexpr void iter_swap( const reverse_iterator& x,
                                 const std::reverse_iterator<Iter2>& y )

    noexcept(/* siehe unten */);
(seit C++20)

Vertauscht die Objekte, auf die zwei angepasste zugrunde liegende Iteratoren zeigen.

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

Diese Funktionenschablone ist für normale nicht qualifizierte oder qualifizierte Suchen nicht sichtbar und kann nur durch argumentabhängige Suche gefunden werden, wenn std::reverse_iterator<Iter> eine zugehörige Klasse der Argumente ist.

Inhalt

[edit] Parameter

x, y - Reverse-Iteratoren für die zu vertauschenden Elemente

[edit] Komplexität

Konstant.

[edit] Ausnahmen

noexcept-Spezifikation:  
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&>()))

)

[edit] Beispiel

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

Ausgabe

3 6
6 3

[edit] Siehe auch

tauscht die Werte von zwei Objekten
(Funktionsvorlage) [edit]
Tauscht zwei Elementbereiche
(Funktionstempelat) [edit]
Tauscht die Elemente, auf die zwei Iteratoren zeigen
(Funktionstempelat) [edit]
(C++20)
tauscht die von zwei dereferenzierbaren Objekten referenzierten Werte
(Customization-Punkt-Objekt)[bearbeiten]
(C++20)
tauscht die Objekte, auf die zwei zugrundeliegende Iteratoren zeigen
(Funktionstemplate) [edit]