hash_multimap::insert
Nota
Esta API está obsoleta.La alternativa es unordered_multimap (Clase).
Inserta un elemento o un intervalo de elementos en un hash_multimap.
iterator insert(
const value_type& Val
);
iterator insert(
const_iterator Where,
const value_type& Val
);
void insert(
initializer_list<value_type> IList
);
template<class InputIterator>
void insert(
InputIterator First,
InputIterator Last
);
template<class ValTy>
iterator insert(
ValTy&& Val
);
template<class ValTy>
iterator insert(
const_iterator Where,
ValTy&& Val
);
Parámetros
Parámetro |
Descripción |
Val |
Valor de un elemento que se va a insertar en el hash_multimap a menos que ya contenga ese elemento o, más en general, a menos que ya contenga un elemento cuya clave se ordena de forma equivalente. |
Where |
Sugerencia sobre dónde empezar a buscar el punto correcto de inserción. |
First |
Posición del primer elemento que se va a copiar de un mapa. |
Last |
Posición situada más allá del último elemento que se va a copiar de un mapa. |
Valor devuelto
Las dos primeras funciones miembro insert devuelven un iterador que apunta a la posición donde se insertó el nuevo elemento.
La tercera función miembro utiliza una initializer_list para los elementos que se van a insertar.
La cuarta función miembro inserta la secuencia de valores de elemento en un mapa que corresponde a cada elemento direccionado por un iterador en el intervalo [First, Last) de un conjunto especificado.
Las dos últimas funciones miembro insert se comportan igual que las dos primeras, salvo que construyen con movimiento el valor insertado.
Comentarios
El value_type de un elemento es un par, de modo que el valor de un elemento será un par ordenado en el que el primer componente es igual que el valor de clave y el segundo componente es igual que el valor de datos del elemento.
La inserción se puede realizar en tiempo constante amortizado para la versión de sugerencia de insert, en lugar de en tiempo logarítmico, si el punto de inserción sigue inmediatamente a Where.
Requisitos
Encabezado: <hash_map>
Espacio de nombres: stdext