std::swap(std::stack)

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Container-Bibliothek

Sequenz

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

Assoziativ

setzt

multiset

map

multimap

Ungeordnete assoziative

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adapter

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Ansichten

span (C++20)

mdspan (C++23)

Tabellen

Iterator-Invalidierung

Mitgliedsfunktionstabelle

Nicht-Mitgliedsfunktionstabelle

 

std::stack

Memberfunktionen

stack::stack

stack::~stack

stack::operator=

Elementzugriff

stack::top

Kapazität

stack::empty

stack::size

Modifizierer

stack::push

stack::push_range (C++23)

stack::emplace (C++11)

stack::pop

stack::swap (C++11)

Nicht-Member-Funktionen

swap(std::stack) (C++11)

operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20)

Hilfsklassen

uses_allocator<std::stack> (C++11)

formatter<std::stack> (C++23)

Deduktionshilfen(C++17)

 

Definiert in Header <stack>
template< class T, class Container > void swap( std::stack<T, Container>& lhs,            std::stack<T, Container>& rhs );		(seit C++11) (bis C++17)
template< class T, class Container > void swap( std::stack<T, Container>& lhs,            std::stack<T, Container>& rhs )                noexcept(/* siehe unten */);		(seit C++17)

Spezialisiert den std::swap Algorithmus für std::stack. Vertauscht die Inhalte von lhs und rhs. Ruft lhs.swap(rhs) auf.

Diese Überladung nimmt nur an der Auflösungsüberladung teil, wenn std::is_swappable_v<Container> true ist.

(seit C++17)

Parameter

lhs, rhs

-

Container, deren Inhalte getauscht werden sollen

Rückgabewert

(keine)

Komplexität

Gleichbedeutend mit dem Vertauschen der zugrunde liegenden Container.

Ausnahmen

noexcept-Spezifikation:   noexcept(noexcept(lhs.swap(rhs)))

(seit C++17)

Anmerkungen

Obwohl die Überladungen von std::swap für Container-Adapter in C++11 eingeführt wurden, können Container-Adapter bereits in C++98 mit std::swap vertauscht werden. Solche Aufrufe von std::swap haben normalerweise eine lineare Zeitkomplexität, aber eine bessere Komplexität kann bereitgestellt werden.

Beispiel

Führen Sie diesen Code aus

#include <algorithm>
#include <iostream>
#include <stack>
 
int main()
{
    std::stack<int> alice;
    std::stack<int> bob;
 
    auto print = [](const auto& title, const auto& cont)
    {
        std::cout << title << " size=" << cont.size();
        std::cout << " top=" << cont.top() << '\n';
    };
 
    for (int i = 1; i < 4; ++i)
        alice.push(i);
    for (int i = 7; i < 11; ++i)
        bob.push(i);
 
    // Print state before swap
    print("Alice:", alice);
    print("Bobby:", bob);
 
    std::cout << "-- SWAP\n";
    std::swap(alice, bob);
 
    // Print state after swap
    print("Alice:", alice);
    print("Bobby:", bob);
}

Ausgabe

Alice: size=3 top=3
Bobby: size=4 top=10
-- SWAP
Alice: size=4 top=10
Bobby: size=3 top=3

Siehe auch

swap (C++11)

tauscht die Inhalte (public member function)