Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes