std::optional<T>::emplace
De cppreference.com
| template< class... Args > T& emplace( Args&&... args ); |
(1) | (desde C++17) |
| template< class U, class... Args > T& emplace( std::initializer_list<U> ilist, Args&&... args ); |
(2) | (desde C++17) |
Construye el valor contenido en el lugar. Si *this ya contiene un valor antes de la llamada, el valor contenido se destruye llamando a su destructor.
1) Inicializa el valor contenido mediante la inicialización directa (pero no con la inicialización directa de lista) ) con std::forward<Args>(args)... como parámetros.
2) Inicializa el valor contenido llamando a su constructor con ilist, std::forward<Args>(args)... como parámetros. Esta sobrecarga solo participa en la resolución de sobrecargas si std::is_constructible<T, std::initializer_list<U>&, Args&&...>::value es true.
Contenido |
[editar] Parámetros
| args... | - | Los argumentos a pasar al constructor. |
| ilist | - | La lista de inicializadores a pasar al constructor. |
| Requisitos de tipo | ||
-T debe poder construirse desde Args... para la sobrecarga (1).
| ||
-T debe poder construirse desde std::initializer_list y Args... para la sobrecarga (2).
| ||
[editar] Valor de retorno
Una referencia al nuevo valor contenido.
[editar] Excepciones
Cualquier excepción lanzada por el constructor seleccionado de T. Si se lanza una excepción, *this no contiene un valor después de esta llamada (el valor contenido previamente, si es que lo había, se ha destruido).
[editar] Ejemplo
Ejecuta este código
#include <optional> #include <iostream> struct A { std::string s; A(std::string str) : s(std::move(str)) { std::cout << " construido\n"; } ~A() { std::cout << " destruido\n"; } A(const A& o) : s(o.s) { std::cout << " construido por copia\n"; } A(A&& o) : s(std::move(o.s)) { std::cout << " construido por movimiento\n"; } A& operator=(const A& other) { s = other.s; std::cout << " asignado por copia\n"; return *this; } A& operator=(A&& other) { s = std::move(other.s); std::cout << " asignado por movimiento\n"; return *this; } }; int main() { std::optional<A> opt; std::cout << "Asignar:\n"; opt = A("Lorem ipsum dolor sit amet, consectetur adipiscing elit nec."); std::cout << "Emplazar:\n"; // Como opt contiene un valor también destruirá ese valor opt.emplace("Lorem ipsum dolor sit amet, consectetur efficitur. "); std::cout << "Fin del ejemplo\n"; }
Salida:
Asignar: construir construido por movimiento destruido Emplazar: destruido construido Fin del ejemplo destruido
[editar] Véase también
| Asigna contenido. (función miembro pública) |
