Archivo de encabezado de la biblioteca estándar <variant>

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Archivos de encabezado de la biblioteca estándar

Apoyo del lenguaje <cfloat> <climits> <compare>(C++20) <coroutine>(C++20) <csetjmp> <csignal> <cstdarg> <cstddef> <cstdint>(C++11) <cstdlib> <exception> <initializer_list>(C++11)    <limits> <new> <source_location>(C++20) <stdfloat>(C++23) <typeinfo> <version>(C++20) Conceptos <concepts>(C++20) Diagnósticos <cassert> <cerrno> <debugging>(C++26) <stacktrace>(C++23) <stdexcept> <system_error>(C++11) Gestión de memoria <memory> <memory_resource>(C++17) <scoped_allocator>(C++11) Metaprogramación <type_traits>(C++11) <ratio>(C++11)

Servicios generales <any>(C++17) <bitset> <bit>(C++20) <charconv>(C++17) <expected>(C++23) <format>(C++20) <functional> <optional>(C++17) <tuple>(C++11) <typeindex>(C++11) <utility> <variant>(C++17) Contenedores <array>(C++11) <deque> <flat_map>(C++23) <flat_set>(C++23) <forward_list>(C++11) <inplace_vector>(C++26)    <list> <map> <mdspan>(C++23) <queue> <set> <span>(C++20) <stack> <unordered_map>(C++11) <unordered_set>(C++11) <vector> Iteradores <iterator> Rangos <generator>(C++23) <ranges>(C++20)

Algoritmos <algorithm> <numeric> Cadenas <cctype> <cstring> <cuchar>(C++11) <cwchar> <cwctype> <string_view>(C++17) <string> Procesamiento de texto <clocale> <codecvt>(C++11/17/26*) <locale> <regex>(C++11) <text_encoding>(C++26)    Numéricos <cfenv>(C++11) <cmath> <complex> <linalg>(C++26) <numbers>(C++20) <random>(C++11) <simd>(C++26) <valarray> Tiempo <chrono>(C++11) <ctime> Compatibilidad con C <ccomplex>(C++11/17/20*) <ciso646>(hasta C++20) <cstdalign>(C++11/17/20*) <cstdbool>(C++11/17/20*) <ctgmath>(C++11/17/20*)

Entrada/Salida <cinttypes>(C++11) <cstdio> <filesystem>(C++17) <fstream> <iomanip> <iosfwd> <iostream> <ios> <istream> <ostream> <print>(C++23) <spanstream>(C++23) <sstream> <streambuf> <strstream>(C++98/26*) <syncstream>(C++20) Apoyo para concurrencia <atomic>(C++11) <barrier>(C++20) <condition_variable>(C++11) <future>(C++11) <hazard_pointer>(C++26) <latch>(C++20) <mutex>(C++11) <rcu>(C++26) <semaphore>(C++20) <shared_mutex>(C++14) <stdatomic.h>(C++23) <stop_token>(C++20) <thread>(C++11) Apoyo de ejecución <execution>(C++17)

 

Clases

variant (C++17)	Una unión discriminada con seguridad de tipo. (plantilla de clase)
monostate (C++17)	Tipo de marcador de posición para usarse como la primer alternativa en un variante de tipos no construibles por defecto. (clase)
bad_variant_access (C++17)	Excepción lanzada durante accesos inválidos al valor de un variante. (clase)
variant_sizevariant_size_v (C++17)	Obtiene el tamaño de la lista de alternativas del variante en tiempo de compilación. (plantilla de clase)(plantilla de variables)
variant_alternativevariant_alternative_t (C++17)	Obtiene el tipo de la alternativa dado su subíndice, en tiempo de compilación. (plantilla de clase)(plantilla de alias)
std::hash<std::variant> (C++17)	Especializa el algoritmo std::hash. (especialización de plantilla de clase)

Asistentes

variant_npos (C++17)

Subíndice del variante en el estado inválido. (constante)

Funciones

visit (C++17)	Llama al objeto función proporcionado con los argumentos mantenidos por uno o más variantes. (plantilla de función)
holds_alternative (C++17)	Comprueba si el variante actualmente mantiene un tipo dado. (plantilla de función)
std::get(std::variant) (C++17)	Lee el valor del variante dado el subíndice o el tipo (si el tipo es único), lanza una excepción si existe un error. (plantilla de función)
get_if (C++17)	Obtiene un puntero al valor de un variante al que se apunta dado el subíndice del tipo (si es único), devuelve nulo cuando existe un error. (plantilla de función)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++17)(C++17)(C++17)(C++17)(C++17)(C++17)(C++20)	Compara objetos variant con sus valores contenidos. (plantilla de función)
std::swap(std::variant) (C++17)	Especializa el algoritmo std::swap. (función)

Sinopsis

namespace std {// variantetemplate<typename... Types>class variant;// clases asistentes para variantetemplate<typename T>struct variant_size;// no definidatemplate<typename T>struct variant_size<const T>;template<typename T>struct variant_size<volatile T>;template<typename T>struct variant_size<constvolatile T>;template<typename T>inlineconstexpr size_t variant_size_v = variant_size<T>::value;template<typename... Types>struct variant_size<variant<Types...>>;template<size_t I, typename T>struct variant_alternative;// no definidatemplate<size_t I, typename T>struct variant_alternative<I, const T>;template<size_t I, typename T>struct variant_alternative<I, volatile T>;template<size_t I, typename T>struct variant_alternative<I, constvolatile T>;template<size_t I, typename T>using variant_alternative_t =typename variant_alternative<I, T>::type;template<size_t I, typename... Types>struct variant_alternative<I, variant<Types...>>;inlineconstexpr size_t variant_npos =-1;// acceso a valortemplate<typename T, typename... Types>constexprbool holds_alternative(const variant<Types...>&)noexcept;template<size_t I, typename... Types>constexpr variant_alternative_t<I, variant<Types...>>& get(variant<Types...>&);template<size_t I, typename... Types>constexpr variant_alternative_t<I, variant<Types...>>&& get(variant<Types...>&&);template<size_t I, typename... Types>constexprconst variant_alternative_t<I, variant<Types...>>& get(const variant<Types...>&);template<size_t I, typename... Types>constexprconst variant_alternative_t<I, variant<Types...>>&& get(const variant<Types...>&&);template<typename T, typename... Types>constexpr T& get(variant<Types...>&);template<typename T, typename... Types>constexpr T&& get(variant<Types...>&&);template<typename T, typename... Types>constexprconst T& get(const variant<Types...>&);template<typename T, typename... Types>constexprconst T&& get(const variant<Types...>&&);template<size_t I, typename... Types>constexpr add_pointer_t<variant_alternative_t<I, variant<Types...>>> get_if(variant<Types...>*)noexcept;template<size_t I, typename... Types>constexpr add_pointer_t<const variant_alternative_t<I, variant<Types...>>> get_if(const variant<Types...>*)noexcept;template<typename T, typename... Types>constexpr add_pointer_t<T> get_if(variant<Types...>*)noexcept;template<typename T, typename... Types>constexpr add_pointer_t<const T> get_if(const variant<Types...>*)noexcept;// operadores relacionalestemplate<typename... Types>constexprbool operator==(const variant<Types...>&, const variant<Types...>&);template<typename... Types>constexprbool operator!=(const variant<Types...>&, const variant<Types...>&);template<typename... Types>constexprbool operator<(const variant<Types...>&, const variant<Types...>&);template<typename... Types>constexprbool operator>(const variant<Types...>&, const variant<Types...>&);template<typename... Types>constexprbool operator<=(const variant<Types...>&, const variant<Types...>&);template<typename... Types>constexprbool operator>=(const variant<Types...>&, const variant<Types...>&);// visitacióntemplate<typename Visitor, typename... Variants>constexpr/*véase definición*/ visit(Visitor&&, Variants&&...);// clase monostatestruct monostate;// operadores relacionales de monostateconstexprbool operator<(monostate, monostate)noexcept;constexprbool operator>(monostate, monostate)noexcept;constexprbool operator<=(monostate, monostate)noexcept;constexprbool operator>=(monostate, monostate)noexcept;constexprbool operator==(monostate, monostate)noexcept;constexprbool operator!=(monostate, monostate)noexcept;// algoritmos especializadostemplate<typename... Types>void swap(variant<Types...>&, variant<Types...>&)noexcept(/*véase definición*/);// clase bad_variant_accessclass bad_variant_access;// soporte para hashtemplate<typename T>struct hash;template<typename... Types>struct hash<variant<Types...>>;template<>struct hash<monostate>;}

Plantilla de clase std::variant

template<typename... Types>class variant {public:// constructoresconstexpr variant()noexcept(/*véase definición*/); variant(const variant&); variant(variant&&)noexcept(/*véase definición*/);template<typename T>constexpr variant(T&&)noexcept(/*véase definición*/);template<typename T, typename... Args>constexprexplicit variant(in_place_type_t<T>, Args&&...);template<typename T, typename U, typename... Args>constexprexplicit variant(in_place_type_t<T>, initializer_list<U>, Args&&...);template<size_t I, typename... Args>constexprexplicit variant(in_place_index_t<I>, Args&&...);template<size_t I, typename U, typename... Args>constexprexplicit variant(in_place_index_t<I>, initializer_list<U>, Args&&...);// destructor ~variant();// asignación variant& operator=(const variant&); variant& operator=(variant&&)noexcept(/*véase definición*/);template<typename T> variant& operator=(T&&)noexcept(/*véase definición*/);// modificadorestemplate<typename T, typename... Args>void emplace(Args&&...);template<typename T, typename U, typename... Args>void emplace(initializer_list<U>, Args&&...);template<size_t I, typename... Args>void emplace(Args&&...);template<size_t I, typename U, typename... Args>void emplace(initializer_list<U>, Args&&...);// estatus del valorconstexprbool valueless_by_exception()constnoexcept;constexpr size_t index()constnoexcept;// intercambiovoid swap(variant&)noexcept(/*véase definición*/);};

Clase std::monostate

struct monostate{};

Clase std::bad_variant_access

class bad_variant_access :public exception {public: bad_variant_access()noexcept;virtualconstchar* what()constnoexcept;};