Namespaces
Variants

    std::expected<T,E>::swap

    Von de.cppreference.net
     
    C++
     
    Dienstprogrammbibliothek
    Sprachunterstützung
    Typunterstützung (Basistypen, RTTI)
    Bibliotheks-Feature-Test-Makros (C++20)
    Programm-Dienstprogramme
    Variadische Funktionen
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Koroutinen-Unterstützung (C++20)
    Vertragsunterstützung (C++26)
    Dreiseitiger Vergleich
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Allgemeine Dienstprogramme
    Relationale Operatoren (veraltet in C++20)
    Ganzzahl-Vergleichsfunktionen
    (C++20)(C++20)(C++20)    
    (C++20)
    Swap und Typoperationen
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    Allgemeine Vokabular-Typen
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    std::expected
     
    Primäre Schablone
    		 
    constexpr void swap( expected& other ) noexcept(/* see below */);
    		(1) (seit C++23)
    void partielle Spezialisierung
    		 
    constexpr void swap( expected& other ) noexcept(/* see below */);
    		(2) (seit C++23)

    Vertauscht die Inhalte mit denen von other.

    1) Die enthaltenen Werte werden wie folgt vertauscht:
    Wert von
     has_value()      		Wert von other.has_value()
    true false
    true using std::swap;
    swap(val, rhs.val);         		siehe unten
    false other.swap(*this); using std::swap;
    swap(unex, rhs.unex);
    Wenn has_value() true ist und other.has_value() false ist, äquivalent zu:

    // Case 1: the move constructions of unexpected values are non-throwing:
    // “other.unex” will be restored if the construction of “other.val” fails
    if constexpr (std::is_nothrow_move_constructible_v<E>)
    {
        E temp(std::move(other.unex));
        std::destroy_at(std::addressof(other.unex));
        try
        {
            std::construct_at(std::addressof(other.val), std::move(val)); // may throw
            std::destroy_at(std::addressof(val));
            std::construct_at(std::addressof(unex), std::move(temp));
        }
        catch(...)
        {
            std::construct_at(std::addressof(other.unex), std::move(temp));
            throw;
        }
    }
    // Case 2: the move constructions of expected values are non-throwing:
    // “this->val” will be restored if the construction of “this->unex” fails
    else
    {
        T temp(std::move(val));
        std::destroy_at(std::addressof(val));
        try
        {
            std::construct_at(std::addressof(unex), std::move(other.unex)); // may throw 
            std::destroy_at(std::addressof(other.unex));
            std::construct_at(std::addressof(other.val), std::move(temp));
        }
        catch(...)
        {
            std::construct_at(std::addressof(val), std::move(temp));
            throw;
        }
    }
    has_val = false;
    rhs.has_val = true;

    Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn alle folgenden Werte true sind:
    • std::is_swappable_v<T>
    • std::is_swappable_v<E>
    • std::is_move_constructible_v<T> && std::is_move_constructible_v<E>
    • std::is_nothrow_move_constructible_v<T> || std::is_nothrow_move_constructible_v<E>
    2) Die unerwarteten Werte werden wie folgt vertauscht:
    Wert von
     has_value()      		Wert von other.has_value()
    true false
    true using std::swap;
    swap(val, rhs.val);         		std::construct_at(std::addressof(unex),
                      std::move(rhs.unex));
    std::destroy_at(std::addressof(rhs.unex));
    has_val = false;
    rhs.has_val = true;
    false other.swap(*this); using std::swap;
    swap(unex, rhs.unex);
    Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn std::is_swappable_v<E> und std::is_move_constructible_v<E> beide true sind.

    Parameter

    other - das expected Objekt, mit dem die Inhalte ausgetauscht werden sollen

    Exceptions

    1)
    noexcept Spezifikation:
    noexcept (

    std:: is_nothrow_move_constructible_v < T > && std:: is_nothrow_swappable_v < T > &&
    std:: is_nothrow_move_constructible_v < E > && std:: is_nothrow_swappable_v < E >

    )
    2)
    noexcept Spezifikation:
    noexcept (

    std:: is_nothrow_move_constructible_v < E > && std:: is_nothrow_swappable_v < E >

    )

    Beispiel

    Diesen Code ausführen 
    #include <expected>
#include <iostream>
#include <string_view>
using Ex = std::expected<std::string, int>;
void show(const Ex& ex1, const Ex& ex2, std::string_view term = "\n")
{
    for (int i{}; i != 2; ++i)
    {
        std::cout << (i ? "ex2" : "ex1");
        if (const Ex& ex = (i ? ex2 : ex1); ex.has_value())
            std::cout << ".value() = " << *ex << "  ";
        else
            std::cout << ".error() = " << ex.error() << "  ";
    }
    std::cout << term;
}
int main()
{
    Ex ex1("\N{CAT FACE}");
    Ex ex2{"\N{GREEN HEART}"};
    show(ex1, ex2, "after ex1.swap(ex2):\n");
    ex1.swap(ex2);
    show(ex1, ex2, "\n\n");
    ex2 = std::unexpected(13);
    show(ex1, ex2, "after ex1.swap(ex2):\n");
    ex1.swap(ex2);
    show(ex1, ex2, "\n\n");
    ex2 = std::unexpected(37);
    show(ex1, ex2, "after ex1.swap(ex2):\n");
    ex1.swap(ex2);
    show(ex1, ex2);
}

    Ausgabe: 

    ex1.value() = 🐱  ex2.value() = 💚  after ex1.swap(ex2):
ex1.value() = 💚  ex2.value() = 🐱 
ex1.value() = 💚  ex2.error() = 13  after ex1.swap(ex2):
ex1.error() = 13  ex2.value() = 💚 
ex1.error() = 13  ex2.error() = 37  after ex1.swap(ex2):
ex1.error() = 37  ex2.error() = 13
    **Übersetzungsdetails:** - "Run this code" → "Diesen Code ausführen" - "Output:" → "Ausgabe:" - Alle HTML-Tags, Attribute und Code-Blöcke wurden unverändert beibehalten - C++-spezifische Begriffe (wie Funktionsnamen, Typen) wurden nicht übersetzt - Die Emoji-Zeichen und numerischen Werte bleiben erhalten - Die Formatierung und Struktur der Webseite wurde vollständig beibehalten

    Siehe auch

    (C++23)
    		spezialisiert den std::swap Algorithmus
    (Funktion)