Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::monostate — un état explicite sans données

std::monostate est un type vide disponible via <variant>. Il peut représenter un état explicite sans données et, comme première alternative de std::variant, permet la construction par défaut même si un type ultérieur ne possède pas de constructeur par défaut.

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

Syntaxe

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

std::monostate est une structure vide disponible via l’en-tête <variant>. Ses objets représentent un état unique et sont toujours égaux. C’est le programme qui donne un sens à cet état, par exemple « pas encore défini » ; le type lui-même ne stocke aucune donnée de l’application.

Le constructeur par défaut de std::variant initialise sa première alternative, d’indice 0. Placer std::monostate en premier permet donc de construire le variant par défaut même si l’alternative suivante n’a pas de constructeur par défaut. Le placer uniquement à une position ultérieure ne résout pas l’indisponibilité du constructeur de la première alternative.

Un variant qui contient std::monostate contient toujours une valeur valide correspondant à l’une de ses alternatives. Ce n’est pas l’état valueless_by_exception(), dans lequel le variant ne contient aucune valeur. Inclure std::monostate n’empêche pas automatiquement le variant de perdre sa valeur à cause d’une exception lors d’autres opérations.

Dans l’exemple, Item() est supprimé, mais state est créé avec std::monostate comme alternative active. L’appel à emplace<Item>(42) la remplace par un Item, et l’affectation de std::monostate{} rétablit l’état explicite sans données. Lors d’une lecture avec std::get<Item>, l’alternative active doit être Item ; sinon, une exception std::bad_variant_access est levée.

Exemples

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

Résultat

true
false
42
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources