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.