CKTIS / C++
std::monostate — um estado explícito sem dados
std::monostate é um tipo vazio disponível através de <variant>. Pode representar um estado explícito sem dados e, como primeira alternativa de std::variant, permite a construção por omissão mesmo quando um tipo posterior não tem construtor por omissão.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <variant>
std::monostate{};
std::variant<std::monostate, T> value;std::monostate é uma estrutura vazia disponível através do cabeçalho <variant>. Os seus objetos representam um único estado e são sempre iguais quando comparados. É o programa que atribui um significado a esse estado, por exemplo, «ainda não definido»; o próprio tipo não armazena dados da aplicação.
O construtor por omissão de std::variant inicializa a primeira alternativa, com o índice 0. Colocar std::monostate em primeiro lugar permite, portanto, construir o variant por omissão, mesmo que a alternativa seguinte não tenha um construtor por omissão. Colocá-lo apenas numa posição posterior não resolve a indisponibilidade do construtor da primeira alternativa.
Um variant que contém std::monostate continua a conter um valor válido de uma das suas alternativas. Este não é o estado valueless_by_exception(), no qual o variant não contém qualquer valor. Incluir std::monostate não impede automaticamente que o variant perca o seu valor devido a uma exceção durante outras operações.
No exemplo, Item() foi eliminado, mas state é criado com std::monostate como alternativa ativa. A chamada emplace<Item>(42) substitui-a por um Item, e a atribuição de std::monostate{} repõe o estado explícito sem dados. Ao ler através de std::get<Item>, a alternativa ativa tem de ser Item; caso contrário, é lançada std::bad_variant_access.
Exemplos
#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';
}
Resultado
true false 42 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.