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

CKTIS / C++

std::get_if : sondage sans exception d’un variant

std::get_if renvoie un pointeur vers l’alternative active demandée de std::variant, ou nullptr sans lancer.

Version : C++23

Syntaxe

template<std::size_t I, class... Types>
constexpr std::add_pointer_t<std::variant_alternative_t<I, std::variant<Types...>>>
std::get_if(std::variant<Types...>* v) noexcept;

template<class T, class... Types>
constexpr std::add_pointer_t<T>
std::get_if(std::variant<Types...>* v) noexcept;

// const-pointer overloads return pointers to const.

std::get_if<I>(&v) choisit par indice, tandis que std::get_if<T>(&v) choisit un type présent exactement une fois. Si le pointeur de variant est non nul et que v.index() correspond, le résultat pointe l’objet stocké ; sinon il vaut nullptr. La surcharge recevant const std::variant* renvoie un pointeur vers const.

Dans l’exemple, le variant contient l’entier 42. Le premier appel fournit un const int* valide ; le sondage de std::string fournit nullptr, donc le programme affiche 42 1. Le pointeur permet l’accès sans second appel à std::get.

L’indice doit être inférieur au nombre d’alternatives et le type choisi doit apparaître exactement une fois. Une violation est une erreur de compilation, pas un résultat nul. La fonction est noexcept et accepte aussi un pointeur de variant nul. Le pointeur renvoyé expire avec le variant ou après un changement d’alternative active et ne possède pas l’objet.

Exemples

#include <iostream>
#include <string>
#include <variant>

int main() {
    std::variant<int, std::string> value = 42;
    if (const int* number = std::get_if<int>(&value)) {
        std::cout << *number;
    }
    std::cout << ' ' << (std::get_if<std::string>(&value) == nullptr) << '\n';
}

Résultat

42 1

std::get_if → 42 1

Sources