std::optional<T>::swap

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

Échange le contenu avec celui de other.

• Si ni *this ni other ne contiennent de valeur, la fonction n'a aucun effet.

• Si un seul de *this et other contient une valeur (appelons cet objet in et l'autre un), la valeur contenue de un est directement initialisée à partir de std::move(*in), suivie de la destruction de la valeur contenue de in comme par in->T::~T(). Après cet appel, in ne contient pas de valeur ; un contient une valeur.

• Si *this et other contiennent tous deux des valeurs, les valeurs contenues sont échangées en appelant using std::swap; swap(**this, *other).

Le programme est mal formé sauf si le type T est Échangeable et que std::is_move_constructible_v<T> est true.

Paramètres

Valeur de retour

(aucun)

Exceptions

En cas d'exception levée, les états des valeurs contenues de * this et other sont déterminés par les garanties de sûreté d'exception du swap du type T ou du constructeur de déplacement de T , selon celui qui est appelé. Pour * this et other , si l'objet contenait une valeur, il reste contenant une valeur, et vice versa.

Remarques

Exemple

#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.'

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi