Namespaces
Variants

std::variant_alternative, std::variant_alternative_t

Материал из ru.cppreference.net
 
 
Библиотека утилит
Поддержка языка
Поддержка типов (базовые типы, RTTI)
Макросы проверки возможностей библиотеки (C++20)
Программные утилиты
Функции с переменным числом аргументов
Поддержка корутин (C++20)
Поддержка контрактов (C++26)
Трёхстороннее сравнение
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

Общие утилиты
Операторы отношений (устаревшее в C++20)
Функции сравнения целых чисел
(C++20)(C++20)(C++20)    
(C++20)
Обмен и операции с типами
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Общеупотребительные типы-обёртки
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)



 
 
Определён в заголовке <variant>
template <std::size_t I, class T>
struct variant_alternative; /* undefined */
(1) (начиная с C++17)
template <std::size_t I, class... Types>
struct variant_alternative<I, variant<Types...>>;
(2) (начиная с C++17)
template <std::size_t I, class T> class variant_alternative<I, const T>;
(3) (начиная с C++17)
template <std::size_t I, class T>
class variant_alternative<I, volatile T>;
template <std::size_t I, class T>
class variant_alternative<I, const volatile T>;
(3) (начиная с C++17)
(устаревшее в C++20)

Предоставляет доступ к типам альтернатив возможно cv-квалифицированного variant по индексу во время компиляции, объединяя cv-квалификации variant (если есть) с cv-квалификациями альтернативы.

Формально,

2) удовлетворяет требованиям TransformationTrait с typedef-элементом type, равным типу альтернативы с индексом I
3) удовлетворяет требованиям TransformationTrait с typedef-элементом type, который обозначает, соответственно, std::add_const_t<std::variant_alternative_t<I,T>>, std::add_volatile_t<std::variant_alternative_t<I,T>> и std::add_cv_t<std::variant_alternative_t<I,T>>

Типы членов

Тип члена Определение
type тип I -й альтернативы варианта, где I должен находиться в диапазоне [0, sizeof...(Types)) , иначе программа является некорректной.

Вспомогательный псевдоним шаблона

template < size_t I, class T >
using variant_alternative_t = typename variant_alternative < I, T > :: type ;
(начиная с C++17)

Пример

#include <variant>
#include <iostream>
using my_variant = std::variant<int, float>;
static_assert(std::is_same_v
    <int,   std::variant_alternative_t<0, my_variant>>);
static_assert(std::is_same_v
    <float, std::variant_alternative_t<1, my_variant>>);
// cv-квалификация типа variant распространяется на извлекаемый альтернативный тип.
static_assert(std::is_same_v
    <const int, std::variant_alternative_t<0, const my_variant>>);
int main()
{
    std::cout << "All static assertions passed.\n";
}

Вывод:

All static assertions passed.

Отчеты о дефектах

Следующие отчеты об изменениях в поведении, содержащие описания дефектов, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Applied to Behavior as published Correct behavior
LWG 2974 C++17 out-of-bounds index resulted in undefined behavior made ill-formed

Смотрите также

получает размер списка альтернатив variant во время компиляции
(шаблон класса) (шаблон переменной)
получает тип указанного элемента
(специализация шаблона класса)