CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Sat, 19 Jul 2025 10:25:09 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/unordered_map/unordered_multimap/operator=/
HTTP/1.1 200 OK
Server: nginx
Date: Sat, 19 Jul 2025 10:25:09 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"8e7e-czsNDdFWQzo2NKMTyVJWO/EMfsM"
Content-Encoding: gzip
Assigns umm (or il) as the new content for the container.
The elements contained in the object before the call are destroyed, and replaced by those in unordered_multimap umm or initializer list il, if any.
The first version (1) performs a copy assignment, which copies all the elements of umm into the container object (with umm preserving its contents).
The second version (2) performs a move assignment, which transfer ownership of the contents of umm to the object. No copies occur: the content is lost by umm.
The third version (3) assigns the contents of the initializer list il as the elements of the container object.
Possible output:
For the move assignment (2): Linear in current container size (destructions).*
For the initializer list assignment (3): On average, linear in sizes (destructions, move-assignments) -- worst case: quadratic.
* Additional complexity for assignments if allocators do not propagate.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<unordered_map>
-
unordered_mapC++11
-
unordered_multimapC++11
unordered_multimap
-
unordered_multimap::~unordered_multimapC++11
-
unordered_multimap::unordered_multimapC++11
member functions
-
unordered_multimap::beginC++11
-
unordered_multimap::bucketC++11
-
unordered_multimap::bucket_countC++11
-
unordered_multimap::bucket_sizeC++11
-
unordered_multimap::cbeginC++11
-
unordered_multimap::cendC++11
-
unordered_multimap::clearC++11
-
unordered_multimap::countC++11
-
unordered_multimap::emplaceC++11
-
unordered_multimap::emplace_hintC++11
-
unordered_multimap::emptyC++11
-
unordered_multimap::endC++11
-
unordered_multimap::equal_rangeC++11
-
unordered_multimap::eraseC++11
-
unordered_multimap::findC++11
-
unordered_multimap::get_allocatorC++11
-
unordered_multimap::hash_functionC++11
-
unordered_multimap::insertC++11
-
unordered_multimap::key_eqC++11
-
unordered_multimap::load_factorC++11
-
unordered_multimap::max_bucket_countC++11
-
unordered_multimap::max_load_factorC++11
-
unordered_multimap::max_sizeC++11
-
unordered_multimap::operator=C++11
-
unordered_multimap::rehashC++11
-
unordered_multimap::reserveC++11
-
unordered_multimap::sizeC++11
-
unordered_multimap::swapC++11
-
non-member overloads
- Reference
- <unordered_map>
- unordered_multimap
- operator=
public member function
<unordered_map>
std::unordered_multimap::operator=
copy (1) | unordered_multimap& operator= ( const unordered_multimap& umm ); |
---|---|
move (2) | unordered_multimap& operator= ( unordered_multimap&& umm ); |
initializer list (3) | unordered_multimap& operator= ( intitializer_list<value_type> il ); |
Assign content
The elements contained in the object before the call are destroyed, and replaced by those in unordered_multimap umm or initializer list il, if any.
The first version (1) performs a copy assignment, which copies all the elements of umm into the container object (with umm preserving its contents).
The second version (2) performs a move assignment, which transfer ownership of the contents of umm to the object. No copies occur: the content is lost by umm.
The third version (3) assigns the contents of the initializer list il as the elements of the container object.
Parameters
- umm
- An unordered_multimap object of the same type (i.e., with the same template parameters).
- il
- An initializer_list object. The compiler will automatically construct such objects from initializer list declarators.
Member type value_type is the type of the elements contained in the unordered_multimap, which is pair<const key_type,mapped_type>, where member type key_type is an alias of the first template parameter (the key type), and mapped_type is an alias of the second template parameter (the mapped type, T).
Return value
*thisExample
|
|
Possible output:
first contains: lemon:yellow apple:red apple:green banana:yellow |
Complexity
For the copy assignment (1): Linear in sizes (destructions, copies).For the move assignment (2): Linear in current container size (destructions).*
For the initializer list assignment (3): On average, linear in sizes (destructions, move-assignments) -- worst case: quadratic.
* Additional complexity for assignments if allocators do not propagate.
Iterator validity
All iterators, references and pointers to elements that were in the container before the call are invalidated.See also
- unordered_multimap::unordered_multimap
- Construct unordered_multimap (public member function)
- unordered_multimap::emplace
- Construct and insert element (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us