KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::monostate — een expliciete toestand zonder gegevens

std::monostate is een leeg type dat beschikbaar is via <variant>. Het kan een expliciete toestand zonder gegevens voorstellen en maakt als eerste alternatief van std::variant standaardconstructie mogelijk, zelfs als een later type geen standaardconstructor heeft.

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

Syntax

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

std::monostate is een lege structuur die beschikbaar is via de header <variant>. De objecten ervan vertegenwoordigen één toestand en zijn altijd gelijk aan elkaar. Het programma geeft die toestand een betekenis, bijvoorbeeld ‘nog niet ingesteld’; het type zelf slaat geen toepassingsgegevens op.

De standaardconstructor van std::variant initialiseert het eerste alternatief, met index 0. Door std::monostate vooraan te plaatsen, kan de variant daarom standaard worden geconstrueerd, zelfs als het volgende alternatief geen standaardconstructor heeft. Het alleen op een latere positie plaatsen verhelpt niet dat de constructor van het eerste alternatief niet beschikbaar is.

Een variant met std::monostate bevat nog steeds een geldige waarde van een van zijn alternatieven. Dit is niet de toestand valueless_by_exception(), waarin de variant geen waarde bevat. Het opnemen van std::monostate voorkomt niet automatisch dat de variant door een uitzondering tijdens andere bewerkingen zijn waarde verliest.

In het voorbeeld is Item() verwijderd, maar wordt state aangemaakt met std::monostate als actief alternatief. De aanroep emplace<Item>(42) vervangt dit door een Item, en de toewijzing std::monostate{} herstelt de expliciete toestand zonder gegevens. Bij het lezen met std::get<Item> moet Item het actieve alternatief zijn; anders wordt std::bad_variant_access gegooid.

Voorbeelden

#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';
}

Resultaat

true
false
42
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen