Namespaces
Variants

std::swap(std::optional)

Depuis fr.cppreference.net
 
 
Bibliothèque d'utilitaires
Support linguistique
Support des types (types de base, RTTI)
Macros de test de fonctionnalités de la bibliothèque (C++20)
Utilitaires de programme
Fonctions variadiques
Support des coroutines (C++20)
Support des contrats (C++26)
Comparaison à trois voies
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

Utilitaires généraux
Opérateurs relationnels (obsolète en C++20)
 
 
Défini dans l'en-tête <optional>
template< class T >
void swap( std::optional<T>& lhs,
           std::optional<T>& rhs ) noexcept(/* see below */);
(depuis C++17)
(constexpr depuis C++20)

Surcharge l'algorithme std::swap pour std::optional. Échange l'état de lhs avec celui de rhs. Appelle effectivement lhs.swap(rhs).

Cette surcharge ne participe à la résolution de surcharge que si std::is_move_constructible_v<T> et std::is_swappable_v<T> sont tous deux des true.

Paramètres

lhs, rhs - optional objets dont les états à échanger

Valeur de retour

(aucun)

Exceptions

noexcept spécification :
noexcept ( noexcept ( lhs. swap ( rhs ) ) )

Notes

Macro de test de fonctionnalité Valeur Std Fonctionnalité
__cpp_lib_optional 202106L (C++20)
(DR20)
Complètement constexpr

Exemple

#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):");
}

Sortie :

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

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.

DR S'applique à Comportement publié Comportement corrigé
P2231R1 C++20 swap n'était pas constexpr alors que les opérations requises pouvaient être constexpr en C++20 rendu constexpr

Voir aussi

échange le contenu
(fonction membre publique)