Namespaces
Variants

std:: swap (std::optional)

From cppreference.net
Utilities library
Definiert im Header <optional>
template < class T >

void swap ( std:: optional < T > & lhs,

std:: optional < T > & rhs ) noexcept ( /* siehe unten */ ) ;
(seit C++17)
(constexpr seit C++20)

Überlädt den std::swap -Algorithmus für std::optional . Tauscht den Zustand von lhs mit dem von rhs aus. Ruft effektiv lhs. swap ( rhs ) auf.

Diese Überladung nimmt nur dann an der Überladungsauflösung teil, wenn std:: is_move_constructible_v < T > und std:: is_swappable_v < T > beide true sind.

Inhaltsverzeichnis

Parameter

lhs, rhs - optional Objekte, deren Zustände ausgetauscht werden sollen

Rückgabewert

(keine)

Ausnahmen

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

Hinweise

Feature-Test Makro Wert Std Funktion
__cpp_lib_optional 202106L (C++20)
(DR20)
Vollständig constexpr

Beispiel

#include <iostream>
#include <optional>
#include <string>
int main()
{
    std::optional<std::string> a{"██████"}, b{"▒▒▒▒▒▒"};
    auto print = [&](auto const& s)
    {
        std::cout << s << "\t"
                     "a = " << a.value_or("(null)") << "  "
                     "b = " << b.value_or("(null)") << '\n';
    };
    print("Initially:");
    std::swap(a, b);
    print("swap(a, b):");
    a.reset();
    print("\n""a.reset():");
    std::swap(a, b);
    print("swap(a, b):");
}

Ausgabe:

Initially:   a = ██████  b = ▒▒▒▒▒▒
swap(a, b):  a = ▒▒▒▒▒▒  b = ██████
a.reset():   a = (null)  b = ██████
swap(a, b):  a = ██████  b = (null)

Fehlerberichte

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

DR Angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
P2231R1 C++20 swap war nicht constexpr während die erforderlichen Operationen in C++20 constexpr sein können als constexpr festgelegt

Siehe auch

tauscht die Inhalte aus
(öffentliche Elementfunktion)