CKTIS / C++
std::monostate — jawny stan bez danych
std::monostate to pusty typ dostępny przez <variant>. Może reprezentować jawny stan bez danych, a jako pierwsza alternatywa std::variant umożliwia jego domyślną konstrukcję, nawet gdy kolejny typ nie ma konstruktora domyślnego.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <variant>
std::monostate{};
std::variant<std::monostate, T> value;std::monostate jest pustą strukturą dostępną przez nagłówek <variant>. Jej obiekty reprezentują jeden stan i zawsze porównują się jako równe. Znaczenie tego stanu, na przykład „jeszcze nie ustawiono”, nadaje program; sam typ nie przechowuje danych aplikacji.
Domyślny konstruktor std::variant inicjalizuje pierwszą alternatywę, czyli tę o indeksie 0. Umieszczenie std::monostate na początku listy pozwala zatem domyślnie skonstruować wariant, nawet jeśli następna alternatywa nie ma konstruktora domyślnego. Umieszczenie go dopiero na dalszej pozycji nie rozwiązuje problemu niedostępnego konstruktora pierwszej alternatywy.
Wariant zawierający std::monostate nadal zawiera poprawną wartość jednej z alternatyw. Nie jest to stan valueless_by_exception(), w którym wariant nie zawiera żadnej wartości. Obecność std::monostate nie zapobiega automatycznie utracie wartości wskutek wyjątku podczas innych operacji.
W przykładzie Item() jest usunięty, ale state powstaje z aktywną alternatywą std::monostate. Wywołanie emplace<Item>(42) zastępuje ją obiektem Item, a przypisanie std::monostate{} przywraca jawny stan bez danych. Przy odczycie przez std::get<Item> aktywną alternatywą musi być Item; w przeciwnym razie zostanie zgłoszony std::bad_variant_access.
Przykłady
#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';
}
Wynik
true false 42 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.