CKTIS / C++
std::variant — uno di un insieme fisso di tipi alternativi
std::variant memorizza un valore di uno dei tipi alternativi specificati dai parametri del modello e ne gestisce la durata. Consente di modellare dati come «numero o testo» e di verificare e gestire in modo sicuro l’alternativa attiva.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);std::variant<Types...> di <variant> rappresenta un insieme chiuso di tipi alternativi. Il valore contenuto è annidato nell’oggetto; è attiva una sola alternativa alla volta, tranne nello stato senza valore descritto di seguito. La costruzione predefinita inizializza con un valore la prima alternativa e richiede che essa sia costruibile per default. Una prima alternativa di tipo std::monostate può rappresentare uno stato vuoto intenzionale.
index() restituisce l’indice, a partire da zero, dell’alternativa attiva. std::get<T>(value) restituisce un riferimento se è attiva l’alternativa di tipo T. Lancia std::bad_variant_access se è attiva un’altra alternativa o se non ce n’è nessuna attiva. std::get_if<T>(&value) restituisce un puntatore o nullptr, senza lanciare eccezioni. L’accesso per tipo richiede che quel tipo compaia esattamente una volta nell’elenco delle alternative; per i tipi ripetuti, usa l’accesso per indice, ad esempio std::get<0>(value).
std::visit(visitor, value) invoca un oggetto chiamabile con il valore attivo. L’oggetto deve gestire ogni alternativa; nella forma di chiamata mostrata, tutti i risultati possibili devono avere lo stesso tipo e la stessa categoria di valore. Un’assegnazione o emplace può cambiare l’alternativa attiva. Un’eccezione durante alcune di queste operazioni può lasciare l’oggetto senza valore: in tal caso valueless_by_exception() restituisce true, index() restituisce std::variant_npos e sia std::get sia std::visit lanciano std::bad_variant_access. È uno stato diverso dal contenere std::monostate.
L’esempio legge prima un int, poi lo sostituisce con uno std::string e gestisce il valore tramite std::visit. Questa voce è destinata a C++23; tale standard riflette l’opzione del compilatore del repository, non un ambiente di produzione attestato. La fonte è una bozza di lavoro in evoluzione e può includere anche funzionalità successive.
Esempi
#include <iostream>
#include <string>
#include <variant>
int main() {
std::variant<int, std::string> value{42};
if (const auto* number = std::get_if<int>(&value)) {
std::cout << *number << '\n';
}
value = std::string{"ready"};
std::cout << value.index() << '\n';
std::visit([](const auto& item) {
std::cout << item << '\n';
}, value);
}
Risultato
42 1 ready
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.