Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::holds_alternative: test aktivního typu variantu

std::holds_alternative<T> bez výjimky testuje, zda std::variant právě ukládá svou jednoznačnou alternativu T.

Verze: C++23

Syntaxe

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

std::holds_alternative<T>(v) vrací true, když v.index() odpovídá indexu typu T v seznamu alternativ. Je constexpr a noexcept a uloženou hodnotu nečte ani nekopíruje. Deklarace vyžaduje, aby se T v Types... vyskytoval právě jednou.

V příkladu je aktivní std::string. Test int je false a test std::string true, takže běžný výpis bool zobrazí 0 1. Po úspěšném testu získáte hodnotu pomocí std::get<T> nebo přímo ukazatel přes std::get_if<T>.

Opakovaný typ, například ve std::variant<int, int>, nelze testovat pomocí holds_alternative<int>: program je chybný; alternativy rozlište přes index(). Variant může být valueless_by_exception(), pak jsou všechny typové testy false. Oddělený test a následná změna vyžadují běžnou synchronizaci mezi vlákny.

Pří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ýsledek

0 1

std::holds_alternative → 0 1

Zdroje