std::any

 

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

 

Definiert in der Header-Datei <any>
class any;		(seit C++17)

Die Klasse any beschreibt einen typsicheren Container für einzelne Werte von jedem kopierkonstruierbaren Typ.

1) Ein Objekt der Klasse any speichert eine Instanz eines beliebigen Typs, der die Konstruktoranforderungen erfüllt, oder ist leer, und dies wird als der Zustand des any-Objekts bezeichnet. Die gespeicherte Instanz wird als enthaltenes Objekt bezeichnet. Zwei Zustände sind äquivalent, wenn sie entweder beide leer sind oder wenn beide nicht leer sind und die enthaltenen Objekte äquivalent sind.

2) Die Nicht-Member-Funktionen any_cast bieten typsicheren Zugriff auf das enthaltene Objekt.

Implementierungen werden ermutigt, dynamische Allokationen für kleine Objekte zu vermeiden, aber eine solche Optimierung darf nur für Typen angewendet werden, für die std::is_nothrow_move_constructible true zurückgibt.

Member functions

(Konstruktor)	konstruiert ein any-Objekt (public member function)
operator=	weist ein any-Objekt zu (public member function)
(Destruktor)	zerstört ein any-Objekt (public member function)
Modifizierer
emplace	ändert das enthaltene Objekt und konstruiert das neue Objekt direkt (public member function)
reset	zerstört das enthaltene Objekt (public member function)
swap	tauscht zwei any-Objekte (public member function)
Observer
has_value	prüft, ob das Objekt einen Wert enthält (public member function)
type	gibt das typeid des enthaltenen Werts zurück (public member function)

Non-member functions

std::swap(std::any) (C++17)	spezialisiert den Algorithmus std::swap (function)
any_cast (C++17)	typsicherer Zugriff auf das enthaltene Objekt (function template)
make_any (C++17)	erstellt ein any-Objekt (function template)

Helper classes

bad_any_cast (C++17)

Ausnahme, die von den Rückgabeformen von any_cast bei einem Typ-Mismatch ausgelöst wird (class)

Notes

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_any	201606L	(C++17)	std::any

Example

Führen Sie diesen Code aus

#include <any>
#include <iostream>
 
int main()
{
    std::cout << std::boolalpha;
 
    // any type
    std::any a = 1;
    std::cout << a.type().name() << ": " << std::any_cast<int>(a) << '\n';
    a = 3.14;
    std::cout << a.type().name() << ": " << std::any_cast<double>(a) << '\n';
    a = true;
    std::cout << a.type().name() << ": " << std::any_cast<bool>(a) << '\n';
 
    // bad cast
    try
    {
        a = 1;
        std::cout << std::any_cast<float>(a) << '\n';
    }
    catch (const std::bad_any_cast& e)
    {
        std::cout << e.what() << '\n';
    }
 
    // has value
    a = 2;
    if (a.has_value())
        std::cout << a.type().name() << ": " << std::any_cast<int>(a) << '\n';
 
    // reset
    a.reset();
    if (!a.has_value())
        std::cout << "no value\n";
 
    // pointer to contained data
    a = 3;
    int* i = std::any_cast<int>(&a);
    std::cout << *i << '\n';
}

Mögliche Ausgabe

int: 1
double: 3.14
bool: true
bad any_cast
int: 2
no value
3

See also

Funktion (C++11)	kopierfähiger Wrapper für jedes kopierkonstruierbare aufrufbare Objekt (Klassen-Template)
move_only_function (C++23)	Move-only-Wrapper für jedes aufrufbare Objekt, das Qualifizierer in einer gegebenen Aufrufsignatur unterstützt (Klassen-Template)
variant (C++17)	eine typsichere diskriminierte Union (Klassentemplate)
optional (C++17)	ein Wrapper, der möglicherweise ein Objekt enthält oder auch nicht (Klassenvorlage)