CKTIS / C++
std::monostate — výslovný stav bez dat
std::monostate je prázdný typ dostupný prostřednictvím <variant>. Může představovat výslovný stav bez dat a jako první alternativa std::variant umožňuje výchozí konstrukci, i když pozdější typ nemá výchozí konstruktor.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <variant>
std::monostate{};
std::variant<std::monostate, T> value;std::monostate je prázdná struktura dostupná prostřednictvím hlavičky <variant>. Její objekty představují jediný stav a vždy se porovnávají jako rovné. Význam tohoto stavu, například „zatím nenastaveno“, určuje program; samotný typ neukládá žádná aplikační data.
Výchozí konstruktor std::variant inicializuje první alternativu s indexem 0. Umístění std::monostate na první místo proto umožňuje výchozí konstrukci variantu, i když následující alternativa nemá výchozí konstruktor. Umístění až na pozdější pozici nevyřeší nedostupnost konstruktoru první alternativy.
Variant obsahující std::monostate stále obsahuje platnou hodnotu jedné ze svých alternativ. Nejde o stav valueless_by_exception(), ve kterém variant neobsahuje žádnou hodnotu. Zařazení std::monostate automaticky nezabrání tomu, aby variant kvůli výjimce během jiných operací o svou hodnotu přišel.
V příkladu je Item() odstraněn, ale state vznikne s aktivní alternativou std::monostate. Volání emplace<Item>(42) ji nahradí objektem Item a přiřazení std::monostate{} obnoví výslovný stav bez dat. Při čtení pomocí std::get<Item> musí být aktivní alternativou Item; jinak se vyvolá std::bad_variant_access.
Příklady
#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';
}
Výsledek
true false 42 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.