std::multimap<Key,T,Compare,Allocator>::emplace_hint
template <class... Args> iterator emplace_hint( const_iterator hint, Args&&... args ); |
(desde C++11) | |
Inserta (emplaza) un nuevo elemento en el contenedor lo más cerca posible de la posición justo antes de hint. El elemento se construye en el sitio, es decir, no se realizan operaciones de copia o movimiento.
El constructor del tipo del elemento (value_type, es decir, std::pair<const Key, T>) se llama con exactamente los mismos argumentos que se suministraron a la función, reenviados con std::forward<Args>(args)....
No se invalidan ni referencias ni iteradores.
Parámetros
| hint | - | El iterador a la posición antes de la cual se insertará el nuevo elemento. |
| args | - | Los argumentos a reenviar al constructor del elemento. |
Valor de retorno
Devuelve un iterador al elemento recién insertado.
Excepciones
Si alguna operación lanza una excepción, esta función no tiene ningún efecto (garantía de excepción fuerte).
Complejidad
En general, logarítmica en el tamaño del contenedor, pero constante amortizada si el nuevo elemento se inserta justo antes de hint.
Véase también
(C++11) |
Construye el elemento en el sitio. (función miembro pública) |
| Inserta elementos o nodos (desde C++17) (función miembro pública) |