CKTIS / C++
std::variant — un type parmi un ensemble fixe de types alternatifs
std::variant stocke une valeur correspondant à l’un des types alternatifs définis par ses paramètres de modèle et gère la durée de vie de cette valeur. Il permet de modéliser des données comme « nombre ou texte » et de vérifier et traiter l’alternative active de manière sûre.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);std::variant<Types...> de <variant> représente un ensemble fermé de types alternatifs. La valeur stockée se trouve dans l’objet ; une seule alternative est active à la fois, sauf dans l’état sans valeur décrit ci-dessous. La construction par défaut initialise par une valeur la première alternative et exige que celle-ci soit constructible par défaut. Une première alternative de type std::monostate peut représenter un état vide intentionnel.
index() renvoie l’indice, à partir de zéro, de l’alternative active. std::get<T>(value) renvoie une référence si l’alternative de type T est active. La fonction lance std::bad_variant_access si une autre alternative est active ou si aucune ne l’est. std::get_if<T>(&value) renvoie un pointeur ou nullptr, sans lancer d’exception. L’accès par type exige que ce type apparaisse exactement une fois dans la liste des alternatives ; si un type est répété, utilisez l’accès par indice, par exemple std::get<0>(value).
std::visit(visitor, value) appelle un objet appelable avec la valeur active. Cet objet doit prendre en charge chaque alternative ; dans la forme d’appel illustrée, tous les résultats possibles doivent avoir le même type et la même catégorie de valeur. Une affectation ou emplace peut changer l’alternative active. Une exception pendant certaines de ces opérations peut laisser l’objet sans valeur : dans ce cas, valueless_by_exception() renvoie true, index() renvoie std::variant_npos et std::get comme std::visit lancent std::bad_variant_access. Cet état est différent du stockage de std::monostate.
L’exemple lit d’abord un int, le remplace ensuite par un std::string, puis traite la valeur avec std::visit. Cette entrée vise C++23 ; cette norme correspond à l’option du compilateur du dépôt et ne confirme pas un environnement d’exécution en production. La source est un brouillon de travail évolutif et peut également contenir des fonctionnalités ultérieures.
Exemples
#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);
}
Résultat
42 1 ready
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.