std::optional<T>::swap

void swap( optional& other ) noexcept(/* see below */);

Tauscht den Inhalt mit dem von other.

• Wenn weder *this noch other einen Wert enthalten, hat die Funktion keine Wirkung.

• Wenn nur eines von *this und other einen Wert enthält (nennen wir dieses Objekt in und das andere un), wird der enthaltene Wert von un durch direkte Initialisierung von std::move(*in) erstellt, gefolgt von der Zerstörung des enthaltenen Wertes von in wie durch in->T::~T(). Nach diesem Aufruf enthält in keinen Wert; un enthält einen Wert.

• Wenn sowohl *this als auch other Werte enthalten, werden die enthaltenen Werte durch Aufruf von using std::swap; swap(**this, *other) ausgetauscht.

Das Programm ist fehlerhaft, es sei denn, der Typ T ist Swappable und std::is_move_constructible_v<T> ist true.

Parameter

Rückgabewert

(keine)

Exceptions

Im Falle einer ausgelösten Exception werden die Zustände der enthaltenen Werte von * this und other durch die Exception-Sicherheitsgarantien von swap des Typs T oder T 's Move-Konstruktor bestimmt, je nachdem welcher aufgerufen wird. Für sowohl * this als auch other gilt: Wenn das Objekt einen Wert enthielt, bleibt es mit einem Wert enthalten, und umgekehrt.

Anmerkungen

Beispiel

#include <iostream>
#include <optional>
#include <string>
int main()
{
    std::optional<std::string> opt1("First example text");
    std::optional<std::string> opt2("2nd text");
    enum Swap { Before, After };
    auto print_opts = [&](Swap e)
    {
        std::cout << (e == Before ? "Before swap:\n" : "After swap:\n");
        std::cout << "opt1 contains '" << opt1.value_or("") << "'\n";
        std::cout << "opt2 contains '" << opt2.value_or("") << "'\n";
        std::cout << (e == Before ? "---SWAP---\n": "\n");
    };
    print_opts(Before);
    opt1.swap(opt2);
    print_opts(After);
    // Swap with only 1 set
    opt1 = "Lorem ipsum dolor sit amet, consectetur tincidunt.";
    opt2.reset();
    print_opts(Before);
    opt1.swap(opt2);
    print_opts(After);
}

Before swap:
opt1 contains 'First example text'
opt2 contains '2nd text'
---SWAP---
After swap:
opt1 contains '2nd text'
opt2 contains 'First example text'
Before swap:
opt1 contains 'Lorem ipsum dolor sit amet, consectetur tincidunt.'
opt2 contains ''
---SWAP---
After swap:
opt1 contains ''
opt2 contains 'Lorem ipsum dolor sit amet, consectetur tincidunt.'

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch