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

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 (вызываемый объект, который можно вызвать с любой комбинацией типов из variant) к 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	-	вызываемый объект, принимающий все возможные альтернативы variant
self	-	variant, передаваемый посетителю

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

1) Результат вызова std::visit.

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

Исключения

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

Примечания

Макрос проверки поддержки функции	Значение	Стандарт	Функция
`__cpp_lib_variant`	`202306L`	(C++26)	метод-член `visit`

Пример

#include <print>
#include <string>
#include <string_view>
#include <variant>
 
struct Base {};
struct Derived : Base {};

// helper type for the visitor
template<class... Ts>
struct overloads : Ts... { using Ts::operator()...; };
 
// the variant to visit
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

См. также

visit

(C++17)

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/variant/visit