std::any::operator=

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Dienstprogramm-Bibliotheken

Sprachunterstützung Typunterstützung (Basistypen, RTTI) Bibliotheks-Feature-Test-Makros (C++20) Programm-Dienstprogramme Variadische Funktionen initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Coroutine-Unterstützung (C++20) Vertragsunterstützung (C++26) Drei-Wege-Vergleich three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Allgemeine Hilfsmittel Funktionsobjekte Bit-Manipulation (C++20) bitset hash (C++11) Relationale Operatoren (in C++20 veraltet) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Ganzzahl-Vergleichsfunktionen cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap und Typ-Operationen swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Gemeinsame Vokabulartypen pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

std::any

Memberfunktionen

any::any

any::~any

any::operator=

Modifizierer

any::emplace

any::reset

any::swap

Observer

any::has_value

any::type

Nicht-Member-Funktionen

swap(std::any)

any_cast

make_any

Hilfsklassen

bad_any_cast

 

any& operator=( const any& rhs );	(1)	(seit C++17)
any& operator=( any&& rhs ) noexcept;	(2)	(seit C++17)
template< typename ValueType > any& operator=( ValueType&& rhs );	(3)	(seit C++17)

Weist den enthaltenen Wert zu.

1) Weist den Zustand von rhs durch Kopieren zu, als ob durch std::any(rhs).swap(*this).

2) Weist den Zustand von rhs durch Verschieben zu, als ob durch std::any(std::move(rhs)).swap(*this). rhs bleibt nach der Zuweisung in einem gültigen, aber nicht spezifizierten Zustand.

3) Weist den Typ und Wert von rhs zu, als ob durch std::any(std::forward<ValueType>(rhs)).swap(*this). Diese Überladung nimmt nur an der Auflösung von Überladungen teil, wenn std::decay_t<ValueType> nicht vom Typ std::any ist und std::is_copy_constructible_v<std::decay_t<ValueType>> true ist.

Template-Parameter

ValueType	-	Typ des enthaltenen Wertes
Typanforderungen
- std::decay_t<ValueType> muss die Anforderungen an CopyConstructible erfüllen.

Parameter

rhs

-

Objekt, dessen enthaltener Wert zugewiesen werden soll

Rückgabewert

*this

Ausnahmen

1,3) Wirft std::bad_alloc oder eine Ausnahme, die vom Konstruktor des enthaltenen Typs ausgelöst wird. Wenn aus irgendeinem Grund eine Ausnahme ausgelöst wird, haben diese Funktionen keine Auswirkung (starke Ausnahmensicherheitsgarantie).

Beispiel

Führen Sie diesen Code aus

#include <any>
#include <cassert>
#include <iomanip>
#include <iostream>
#include <string>
#include <typeinfo>
 
int main()
{
    using namespace std::string_literals;
    std::string cat{"cat"};
 
    std::any a1{42};
    std::any a2{cat};
    assert(a1.type() == typeid(int));
    assert(a2.type() == typeid(std::string));
 
    a1 = a2; // overload (1)
    assert(a1.type() == typeid(std::string));
    assert(a2.type() == typeid(std::string));
    assert(std::any_cast<std::string&>(a1) == cat);
    assert(std::any_cast<std::string&>(a2) == cat);
 
    a1 = 96; // overload (3)
    a2 = "dog"s; // overload (3)
    a1 = std::move(a2); // overload (2)
    assert(a1.type() == typeid(std::string));
    assert(std::any_cast<std::string&>(a1) == "dog");
    // The state of a2 is valid but unspecified. In fact,
    // it is void in gcc/clang and std::string in msvc.
    std::cout << "a2.type(): " << std::quoted(a2.type().name()) << '\n';
 
    a1 = std::move(cat); // overload (3)
    assert(*std::any_cast<std::string>(&a1) == "cat");
    // The state of cat is valid but indeterminate:
    std::cout << "cat: " << std::quoted(cat) << '\n';
}

Mögliche Ausgabe

a2.type(): "void"
cat: ""

Siehe auch

(Konstruktor)

konstruiert ein any-Objekt (public member function)