Namespaces
Variants

    std::variant<Types...>::visit

    Начиная с ru.cppreference.net
     
    C++
    Поддержка компиляторов
    Автономное и размещённое исполнение
    Язык
    Стандартная библиотека
    Заголовки стандартной библиотеки
    Именованные требования
    Макросы проверки возможностей (C++20)
    Библиотека поддержки языка
    Библиотека концепций (C++20)
    Библиотека диагностики
    Библиотека управления памятью
    Библиотека метапрограммирования (C++11)
    Библиотека общих утилит
    Библиотека контейнеров
    Библиотека итераторов
    Библиотека диапазонов (C++20)
    Библиотека алгоритмов
    Библиотека строк
    Библиотека обработки текста
    Библиотека численных операций
    Библиотека времени и дат
    Библиотека ввода/вывода
    Библиотека файловой системы (C++17)
    Библиотека поддержки конкурентности (C++11)
    Библиотека управления исполнением (C++26)
    Технические спецификации
    Указатель символов
    Внешние библиотеки
     
    Библиотека утилит
    Поддержка языка
    Поддержка типов (базовые типы, RTTI)
    Макросы проверки возможностей библиотеки (C++20)
    Утилиты программы
    Функции с переменным числом аргументов
    (C++11)
    (C++20)
    (C++26)
    (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++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Общие утилиты
    Операторы отношений (устарело в C++20)
     
    std::variant
     
    template< class Self, class Visitor >
constexpr decltype(auto) visit( this Self&& self, Visitor&& vis );
    		(1) (начиная с C++26) 
    template< class R, class Self, class Visitor >
constexpr R visit( this Self&& self, Visitor&& vis );
    		(2) (начиная с C++26)

    Применяет посетителя vis (вызываемый объект Callable, который можно вызывать с любой комбинацией типов из variant) к варианту, хранящемуся в self.

    Пусть тип V будет decltype(std::forward_like<Self>(std::declval<variant>())), эквивалентный вызов:

    1) return std::visit(std::forward<Visitor>(vis), (V) self);.
    2) return std::visit<R>(std::forward<Visitor>(vis), (V) self);.

    Параметры

    vis - a Callable that accepts every possible alternative from the variant
    self - variant to pass to the visitor

    Возвращаемое значение

    1) Результат вызова std :: visit .
    2) Ничего, если R является (возможно, cv-квалифицированным) void ; иначе результат вызова std :: visit < R > .

    Исключения

    Выбрасывает исключение только в том случае, если вызов std :: visit выбрасывает исключение.

    Примечания

    Макрос тестирования возможностей Значение Стандарт Возможность
    __cpp_lib_variant 202306L (C++26) member visit

    Пример

    Запустить этот код 
    #include <print>
#include <string>
#include <string_view>
#include <variant>
struct Base {};
struct Derived : Base {};
// вспомогательный тип для посетителя
template<class... Ts>
struct overloads : Ts... { using Ts::operator()...; };
// вариант для посещения
using var_t = std::variant<int, std::string, Derived>;
int main()
{
    const auto visitor = overloads
    {
        [](int i){ std::print("int = {}\n", i); },
        [](std::string_view s){ std::println("string = “{}”", s); },
        [](const Base&){ std::println("base"); }
    };
    const var_t var1 = 42, var2 = "abc", var3 = Derived();
#if (__cpp_lib_variant >= 202306L)
    var1.visit(visitor);
    var2.visit(visitor);
    var3.visit(visitor);
#else
    std::visit(visitor, var1);
    std::visit(visitor, var2);
    std::visit(visitor, var3);
#endif
}

    Вывод: 

    int = 42
string = “abc”
base

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

    (C++17)
    		вызывает предоставленный функтор с аргументами, содержащимися в одном или нескольких variant s
    (шаблон функции)