std::variant<Types...>::valueless_by_exception

 

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::variant

Memberfunktionen

variant::variant

variant::~variant

variant::operator=

Observer

variant::index

variant::valueless_by_exception

Modifizierer

variant::emplace

variant::swap

Besuch

variant::visit (C++26)

Nicht-Member-Funktionen

visit(std::variant)

holds_alternative

get(std::variant)

get_if

operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20)

swap(std::variant)

Hilfsklassen

monostate

bad_variant_access

variant_size

variant_alternative

hash<std::variant>

Hilfsobjekte

variant_npos

 

constexpr bool valueless_by_exception() const noexcept;		(seit C++17)

Gibt false genau dann zurück, wenn das variant einen Wert enthält.

Anmerkungen

Ein variant kann beim Initialisieren des enthaltenen Wertes in folgenden Situationen wertlos werden:

• (garantiert) eine Ausnahme wird während der Verschiebezuweisung ausgelöst
• (optional) eine Ausnahme wird während der Kopierzuweisung ausgelöst
• (optional) eine Ausnahme wird während einer typverändernden Zuweisung ausgelöst
• (optional) eine Ausnahme wird während eines typverändernden emplace ausgelöst

Da variant niemals dynamischen Speicher zuweisen darf, kann der vorherige Wert in diesen Situationen nicht beibehalten und somit nicht wiederhergestellt werden. Die "optionalen" Fälle können das Auslösen einer Ausnahme vermeiden, wenn der Typ nicht-ausnahmeauslösende Verschiebungen bereitstellt und die Implementierung zuerst den neuen Wert auf dem Stack konstruiert und ihn dann in das variant verschiebt.

Dies gilt auch für variants von Nicht-Klassen-Typen.

struct S
{
    operator int() { throw 42; }
};
std::variant<float, int> v{12.f}; // OK
v.emplace<1>(S()); // v may be valueless

Ein variant, das wertlos durch Ausnahme ist — d. h. keinen Wert aufgrund einer früheren Ausnahme aus einer der oben genannten Situationen hat — wird als in einem ungültigen Zustand behandelt.

• index gibt variant_npos zurück.
• get löst bad_variant_access aus.
• visit und Member-visit(seit C++26) lösen bad_variant_access aus.

Beispiel

Führen Sie diesen Code aus

#include <cassert>
#include <iostream>
#include <stdexcept>
#include <string>
#include <variant>
 
struct Demo
{
    Demo(int) {}
    Demo(const Demo&) { throw std::domain_error("copy ctor"); }
    Demo& operator= (const Demo&) = default;
};
 
int main()
{
    std::variant<std::string, Demo> var{"str"};
    assert(var.index() == 0);
    assert(std::get<0>(var) == "str");
    assert(var.valueless_by_exception() == false);
 
    try
    {
        var = Demo{555};
    }
    catch (const std::domain_error& ex)
    {
        std::cout << "1) Exception: " << ex.what() << '\n';
    }
    assert(var.index() == std::variant_npos);
    assert(var.valueless_by_exception() == true);
 
    // Now the var is "valueless" which is an invalid state caused
    // by an exception raised in the process of type-changing assignment.
 
    try
    {
        std::get<1>(var);
    }
    catch (const std::bad_variant_access& ex)
    {
        std::cout << "2) Exception: " << ex.what() << '\n';
    }
 
    var = "str2";
    assert(var.index() == 0);
    assert(std::get<0>(var) == "str2");
    assert(var.valueless_by_exception() == false);
}

Mögliche Ausgabe

1) Exception: copy ctor
2) Exception: std::get: variant is valueless

Siehe auch

get(std::variant) (C++17)	liest den Wert des variants anhand des Index oder des Typs (wenn der Typ eindeutig ist), wirft bei Fehler (function template)
index	gibt den nullbasierten Index der vom variant gehaltenen Alternative zurück (public member function)
bad_variant_access (C++17)	Ausnahme, die bei ungültigen Zugriffen auf den Wert eines variant geworfen wird (class)