std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: merge
|
template
<
class
H2,
class
P2
>
void merge ( std:: unordered_map < Key, T, H2, P2, Allocator > & source ) ; |
(1) |
(desde C++17)
(constexpr desde C++26) |
|
template
<
class
H2,
class
P2
>
void merge ( std:: unordered_map < Key, T, H2, P2, Allocator > && source ) ; |
(2) |
(desde C++17)
(constexpr desde C++26) |
|
template
<
class
H2,
class
P2
>
void merge ( std:: unordered_multimap < Key, T, H2, P2, Allocator > & source ) ; |
(3) |
(desde C++17)
(constexpr desde C++26) |
|
template
<
class
H2,
class
P2
>
void merge ( std:: unordered_multimap < Key, T, H2, P2, Allocator > && source ) ; |
(4) |
(desde C++17)
(constexpr desde C++26) |
Intenta extraer ("empalmar") cada elemento en source e insertarlo en * this usando la función hash y el predicado de igualdad de claves de * this .
Si get_allocator ( ) == source. get_allocator ( ) es false , el comportamiento es indefinido.
No se copian ni mueven elementos, solo se redirigen los punteros internos de los nodos del contenedor. Todos los punteros y referencias a los elementos transferidos siguen siendo válidos, pero ahora se refieren a * this , no a source . Los iteradores que se refieren a los elementos transferidos y todos los iteradores que se refieren a * this quedan invalidados.
Contenidos |
Parámetros
| source | - | contenedor compatible para transferir los nodos desde |
Complejidad
Dado S como size ( ) y N como source. size ( ) :
Ejemplo
#include <iostream> #include <string> #include <unordered_map> #include <utility> // print out a std::pair template<class Os, class U, class V> Os& operator<<(Os& os, const std::pair<U,V>& p) { return os << '{' << p.first << ", " << p.second << '}'; } // print out an associative container template<class Os, class K, class V> Os& operator<<(Os& os, const std::unordered_multimap<K, V>& v) { os << '[' << v.size() << "] {"; bool o{}; for (const auto& e : v) os << (o ? ", " : (o = 1, "")) << e; return os << "}\n"; } int main() { std::unordered_multimap<std::string, int> p{{"C", 3}, {"B", 2}, {"A", 1}, {"A", 0}}, q{{"E", 6}, {"E", 7}, {"D", 5}, {"A", 4}}; std::cout << "p: " << p << "q: " << q; p.merge(q); std::cout << "p.merge(q);\n" << "p: " << p << "q: " << q; }
Salida posible:
p: [4] {{A, 1}, {A, 0}, {B, 2}, {C, 3}}
q: [4] {{A, 4}, {D, 5}, {E, 6}, {E, 7}}
p.merge(q);
p: [8] {{E, 6}, {E, 7}, {C, 3}, {A, 1}, {A, 0}, {A, 4}, {D, 5}, {B, 2}}
q: [0] {}
Véase también
|
(C++17)
|
extrae nodos del contenedor
(función miembro pública) |
|
inserta elementos
o nodos
(desde C++17)
(función miembro pública) |