Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::holds_alternative: test aktívneho typu variantu

std::holds_alternative<T> bez výnimky testuje, či std::variant práve ukladá svoju jednoznačnú alternatívu T.

Verzia: C++23

Syntax

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

std::holds_alternative<T>(v) vracia true, keď v.index() zodpovedá indexu typu T v zozname alternatív. Je constexpr a noexcept a uloženú hodnotu nečíta ani nekopíruje. Deklarácia vyžaduje, aby sa T v Types... vyskytoval práve raz.

V príklade je aktívny std::string. Test int je false a test std::string true, takže bežný výpis bool zobrazí 0 1. Po úspešnom teste získate hodnotu cez std::get<T> alebo priamo ukazovateľ cez std::get_if<T>.

Opakovaný typ, napríklad v std::variant<int, int>, nemožno testovať cez holds_alternative<int>: program je chybný; alternatívy rozlíšte cez index(). Variant môže byť valueless_by_exception(), potom sú všetky typové testy false. Oddelený test a následná zmena vyžadujú bežnú synchronizáciu medzi vláknami.

Príklady

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

Výsledok

0 1

std::holds_alternative → 0 1

Zdroje