Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::get_if: bezwyjątkowe sprawdzenie wariantu

std::get_if zwraca wskaźnik do żądanej aktywnej alternatywy std::variant albo nullptr bez rzucania wyjątku.

Wersja: C++23

Składnia

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) wybiera alternatywę przez indeks, a std::get_if<T>(&v) przez typ występujący dokładnie raz. Gdy wskaźnik do wariantu nie jest null i v.index() odpowiada wyborowi, wynik wskazuje przechowywany obiekt; w przeciwnym razie wynikiem jest nullptr. Przeciążenie dla const std::variant* zwraca wskaźnik do const.

W przykładzie wariant przechowuje int o wartości 42. Pierwsze wywołanie daje poprawny const int*, a próba pobrania std::string daje nullptr, więc program wypisuje 42 1. Wskaźnik umożliwia odczyt bez dodatkowego wywołania std::get.

Indeks musi być mniejszy od liczby alternatyw, a typ musi występować dokładnie raz; naruszenie tych warunków jest błędem kompilacji, nie wynikiem null. Funkcja jest noexcept i akceptuje także nullowy wskaźnik do wariantu. Zwrócony wskaźnik traci ważność wraz z wariantem lub po operacji zmieniającej aktywną alternatywę; nie myl go z właścicielem obiektu.

Przykłady

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

Wynik

42 1

std::get_if → 42 1

Źródła