WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::monostate — ein expliziter Zustand ohne Daten

std::monostate ist ein leerer Typ aus <variant>. Er kann einen expliziten Zustand ohne Daten darstellen und ermöglicht als erste Alternative von std::variant die Standardkonstruktion, selbst wenn ein späterer Typ keinen Standardkonstruktor besitzt.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <variant>
std::monostate{};
std::variant<std::monostate, T> value;

std::monostate ist eine leere Struktur, die über den Header <variant> verfügbar ist. Ihre Objekte stellen einen einzigen Zustand dar und sind immer gleich. Die Bedeutung dieses Zustands, etwa „noch nicht gesetzt“, legt das Programm fest; der Typ selbst speichert keine Anwendungsdaten.

Der Standardkonstruktor von std::variant initialisiert die erste Alternative mit Index 0. Steht std::monostate an erster Stelle, kann das Variant daher standardmäßig konstruiert werden, selbst wenn die nächste Alternative keinen Standardkonstruktor besitzt. Wird std::monostate erst an einer späteren Position eingefügt, behebt das keinen nicht verfügbaren Konstruktor der ersten Alternative.

Ein Variant, das std::monostate enthält, enthält weiterhin einen gültigen Wert einer seiner Alternativen. Das ist nicht der Zustand valueless_by_exception(), in dem das Variant keinen Wert enthält. Das Einbeziehen von std::monostate verhindert nicht automatisch, dass das Variant durch eine Ausnahme bei anderen Operationen seinen Wert verliert.

Im Beispiel ist Item() gelöscht, aber state wird mit aktiver Alternative std::monostate erstellt. Der Aufruf emplace<Item>(42) ersetzt sie durch ein Item; die Zuweisung std::monostate{} stellt den expliziten Zustand ohne Daten wieder her. Beim Lesen mit std::get<Item> muss Item die aktive Alternative sein; andernfalls wird std::bad_variant_access ausgelöst.

Beispiele

#include <iostream>
#include <variant>

struct Item {
    int value;
    Item() = delete;
    explicit Item(int n) : value(n) {}
};

int main() {
    std::variant<std::monostate, Item> state;
    std::cout << std::boolalpha;
    std::cout << std::holds_alternative<std::monostate>(state) << '\n';
    std::cout << state.valueless_by_exception() << '\n';

    state.emplace<Item>(42);
    std::cout << std::get<Item>(state).value << '\n';

    state = std::monostate{};
    std::cout << state.index() << '\n';
}

Ergebnis

true
false
42
0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen