std::variant<Types...>::visit
Desde es.cppreference.net
template< class Self, class Visitor >
constexpr decltype(auto) visit( this Self&& self, Visitor&& vis );
|
(1) | (desde C++26) |
template< class R, class Self, class Visitor >
constexpr R visit( this Self&& self, Visitor&& vis );
|
(2) | (desde C++26) |
Aplica el visitante vis (un Callable que puede ser llamado con cualquier combinación de tipos de la variante) a la variante contenida en self.
Dado el tipo V como decltype(std::forward_like<Self>(std::declval<variant>())), la llamada equivalente es:
1)
return std::visit(std::forward<Visitor>(vis), (V) self);.2)
return std::visit<R>(std::forward<Visitor>(vis), (V) self);.Parámetros
| vis | - | un Callable que acepta cada alternativa posible de la variante |
| self | - | variante que se pasa al visitante |
Valor de retorno
1)
El resultado de la invocación
std
::
visit
.
2)
Nada si
R
es (posiblemente calificado con cv)
void
; de lo contrario, el resultado de la invocación
std
::
visit
<
R
>
.
Excepciones
Solo lanza si la llamada a std :: visit lanza.
Notas
| Macro de prueba de características | Valor | Estándar | Característica |
|---|---|---|---|
__cpp_lib_variant
|
202306L
|
(C++26) |
member
visit
|
Ejemplo
Ejecutar este código
#include <print> #include <string> #include <string_view> #include <variant> struct Base {}; struct Derived : Base {}; // tipo auxiliar para el visitor template<class... Ts> struct overloads : Ts... { using Ts::operator()...; }; // el variant a visitar 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 }
Salida:
int = 42 string = “abc” base
Véase también
|
(C++17)
|
llama al funtor proporcionado con los argumentos contenidos en una o más
variant
s
(plantilla de función) |