std::deque<T,Allocator>:: emplace_front
|
template
<
class
...
Args
>
void emplace_front ( Args && ... args ) ; |
(desde C++11)
(hasta C++17) |
|
|
template
<
class
...
Args
>
reference emplace_front ( Args && ... args ) ; |
(desde C++17)
(constexpr desde C++26) |
|
Inserta un nuevo elemento al principio del contenedor. El elemento se construye mediante std::allocator_traits::construct , que normalmente utiliza placement new para construir el elemento in-situ en la ubicación proporcionada por el contenedor. Los argumentos args... se reenvían al constructor como std:: forward < Args > ( args ) ... .
Todos los iteradores (incluyendo el
end()
iterator) quedan invalidados. Ninguna referencia queda invalidada.
Contenidos |
Parámetros
| args | - | argumentos a reenviar al constructor del elemento |
| Requisitos de tipo | ||
-
T
no es
EmplaceConstructible
en
deque
desde
args...
, el comportamiento es indefinido.
|
||
Valor de retorno
| (ninguno) | (until C++17) |
| Una referencia al elemento insertado. | (since C++17) |
Complejidad
Constante.
Excepciones
Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( strong exception safety guarantee ).
Véase también
|
inserta un elemento al principio
(función miembro pública) |