std::any::emplace

 

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

 

Biblioteca de servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Biblioteca de macros de prueba de característica(C++20) Servicios del programa Apoyo de corrutinas(C++20) Funciones variádicas is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Comparación de tres vías three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits(C++20) bitset hash (C++11) Operadores relacionales(en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Intercambio y operaciones de tipos swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Tipos vocabulario comunes pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

std::any

Funciones miembro

any::any

any::~any

any::operator=

Modificadores

any::emplace

any::reset

any::swap

Observadores

any::has_value

any::type

Funciones no miembro

swap(std::any)

any_cast

make_any

 

template<class ValueType, class... Args> std::decay_t<ValueType>& emplace( Args&&... args);	(1)	(desde C++17)
template<class ValueType, class U, class... Args> std::decay_t<ValueType>& emplace(std::initializer_list<U> il, Args&&... args);	(2)	(desde C++17)

Cambia el objeto contenido a uno de tipo std::decay_t<ValueType>, construído a partir de los argumentos.

Primero destruye el objeto contenido actual (si es que lo hay) mediante reset(), luego:

1) Construye un objeto de tipo std::decay_t<ValueType>, usando la inicialización directa de no lista a partir de std::forward<Args>(args)..., como el objeto contenido.

• Esta sobrecarga solo participa en la resolución de sobrecargas si tanto std::is_constructible_v<std::decay_t<ValueType>, Args...> como std::is_copy_constructible_v<std::decay_t<ValueType>> son true.

2) Construye un objeto de tipo std::decay_t<ValueType>, usando la inicialización directa de no lista a partir de il, std::forward<Args>(args)..., como el objeto contenido.

• Esta sobrecarga solo participa en la resolución de sobrecargas si tanto std::is_constructible_v<std::decay_t<ValueType>, std::initializer_list<U>&, Args...> como std::is_copy_constructible_v<std::decay_t<ValueType>> son true.

Parámetros de plantilla

ValueType	-	Tipo del valor contenido.
Requisitos de tipo
- std::decay_t<ValueType> debe satisfacer los requisitos de CopyConstructible.

Valor de retorno

Una referencia al nuevo objeto contenido.

Excepciones

Lanza cualquier excepción lanzada por el constructor de T. Si se lanza una excepción, el objeto previamente contenido (si es que lo hay) se destruye, y *this no contiene un valor.

Ejemplo

Ejecuta este código

#include <algorithm>#include <any>#include <iostream>#include <string>#include <vector>   class Estrella {std::string nombre;int id;   public: Estrella(std::string nombre, int id): nombre { nombre }, id { id }{std::cout<<"Estrella::Estrella(string, int)\n";}   void imprimir()const{std::cout<<"Estrella{ \""<< nombre <<"\" : "<< id <<" };\n";}};   auto main()->int{std::any celestial;// (1) emplace( Args&&... args ); celestial.emplace<Estrella>("Procyon", 2943);constauto* estrella =std::any_cast<Estrella>(&celestial); estrella->imprimir();   std::any av;// (2) emplace( std::initializer_list<U> il, Args&&... args ); av.emplace<std::vector<char>>({'C', '+', '+', '1', '7'}/* no argumentos */);std::cout<< av.type().name()<<'\n';constauto* va =std::any_cast<std::vector<char>>(&av);std::for_each(va->cbegin(), va->cend(), [](charconst& c){std::cout<< c;});std::cout<<'\n';}

Posible salida:

Estrella::Estrella(string, int) Estrella{ "Procyon" : 2943 }; St6vectorIcSaIcEE C++17

Véase también

(constructor)	Construye un objeto any. (función miembro pública)
reset	Destruye el objeto contenido. (función miembro pública)