Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::holds_alternative: test aktywnego typu wariantu

std::holds_alternative<T> bezwyjątkowo sprawdza, czy std::variant przechowuje właśnie swoją jednoznaczną alternatywę T.

Wersja: C++23

Składnia

template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;

std::holds_alternative<T>(v) zwraca true, gdy v.index() równa się indeksowi typu T na liście alternatyw. Funkcja jest constexpr i noexcept; nie odczytuje ani nie kopiuje przechowywanej wartości. Warunkiem poprawności deklaracji jest wystąpienie T dokładnie raz w Types....

W przykładzie aktywną alternatywą jest std::string. Test int daje false, a test std::string true, więc standardowe drukowanie bool wypisuje 0 1. Po udanym teście wartość można pobrać przez std::get<T> albo od razu uzyskać wskaźnik przez std::get_if<T>.

Powtórzony typ, np. std::variant<int, int>, nie może być testowany przez holds_alternative<int>: program jest źle sformułowany; wtedy rozróżniaj alternatywy przez index(). Wariant może być valueless_by_exception(), wtedy żaden test typu nie jest prawdziwy. Oddzielony test i późniejsza mutacja wymagają zwykłej synchronizacji, gdy obiekt jest współdzielony między wątkami.

Przykłady

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

int main() {
    std::variant<int, std::string> state = std::string{"ready"};
    std::cout << std::holds_alternative<int>(state) << ' '
              << std::holds_alternative<std::string>(state) << '\n';
}

Wynik

0 1

std::holds_alternative → 0 1

Źródła