KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::get_if: variant controleren zonder exceptie

std::get_if retourneert een pointer naar het gevraagde actieve std::variant-alternatief of nullptr zonder te werpen.

Versie: C++23

Syntax

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) kiest per index, terwijl std::get_if<T>(&v) een type kiest dat precies eenmaal voorkomt. Als de variantpointer niet null is en v.index() overeenkomt, wijst het resultaat naar het opgeslagen object; anders is het nullptr. De overload voor const std::variant* retourneert een pointer naar const.

In het voorbeeld bevat de variant integer 42. De eerste aanroep levert een geldige const int*; controleren op std::string levert nullptr, zodat de uitvoer 42 1 is. Via de pointer is geen tweede aanroep van std::get nodig.

De index moet kleiner zijn dan het aantal alternatieven en het type moet precies eenmaal voorkomen. Schending is een compile-timefout, geen null-resultaat. De functie is noexcept en accepteert ook een null variantpointer. De pointer vervalt met de variant of bij wijziging van het actieve alternatief en bezit het object niet.

Voorbeelden

#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';
}

Resultaat

42 1

std::get_if → 42 1

Bronnen