| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Sat, 19 Jul 2025 10:40:30 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/unordered_map/unordered_multimap/swap/
HTTP/1.1 200 OK
Server: nginx
Date: Sat, 19 Jul 2025 10:40:31 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"8998-mFPP+DGPkKln1j9uI6oqSx0U6AY"
Content-Encoding: gzip
Exchanges the content of the container by the content of umm, which is another unordered_multimap object containing elements of the same type. Sizes may differ.
After the call to this member function, the elements in this container are those which were in umm before the call, and the elements of umm are those which were in this. Other objects kept internally by the containers (such as their hasher or key_equal objects) are also swapped.
This function exchanges internal pointers to data between the containers without actually performing any copies or moves on the individual elements, allowing for constant time execution no matter the sizes.
Notice that a global algorithm function exists with this same name, swap. This global function is overloaded for unordered_multimap arguments to have the same behavior and complexity as this member function.
Possible output:
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
public member function
<unordered_map>
std::unordered_multimap::swap
void swap ( unordered_multimap& umm );
Swap content
After the call to this member function, the elements in this container are those which were in umm before the call, and the elements of umm are those which were in this. Other objects kept internally by the containers (such as their hasher or key_equal objects) are also swapped.
This function exchanges internal pointers to data between the containers without actually performing any copies or moves on the individual elements, allowing for constant time execution no matter the sizes.
Notice that a global algorithm function exists with this same name, swap. This global function is overloaded for unordered_multimap arguments to have the same behavior and complexity as this member function.
Parameters
- umm
- Another unordered_multimap container object of the same type as this.
Return value
noneExample
|
|
Possible output:
a: pear:OR strawberry:LA strawberry:NC b: orange:FL apple:NY apple:WA |
Complexity
Constant.Iterator validity
All iterators, pointers and references remain valid, but now are referring to elements in the other container, and iterate in it.See also
- swap (unordered_multimap)
- Exchanges contents of two unordered_multimap containers (function template)
- swap
- Exchange values of two objects (function template)
- swap_ranges
- Exchange values of two ranges (function template)
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