Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje