std::unordered_set<Key,Hash,KeyEqual,Allocator>:: operator=
|
unordered_set
&
operator
=
(
const
unordered_set
&
other
)
;
|
(1) |
(since C++11)
(constexpr since C++26) |
| (2) | ||
|
unordered_set
&
operator
=
(
unordered_set
&&
other
)
;
|
(since C++11)
(until C++17) |
|
|
unordered_set
&
operator
=
(
unordered_set
&&
other
)
noexcept ( /* see below */ ) ; |
(since C++17)
(constexpr since C++26) |
|
|
unordered_set
&
operator
=
(
std::
initializer_list
<
value_type
>
ilist
)
;
|
(3) |
(since C++11)
(constexpr since C++26) |
Replaces the contents of the container.
Let
traits
be
std::
allocator_traits
<
allocator_type
>
:
Contents |
Parameters
| other | - | another container to use as data source |
| ilist | - | initializer list to use as data source |
Return value
* this
Complexity
Exceptions
|
2)
noexcept
specification:
noexcept
(
std::
allocator_traits
<
Allocator
>
::
is_always_equal
::
value
&&
std::
is_nothrow_move_assignable
<
Hash
>
::
value
|
(since C++17) |
Notes
After container move assignment (overload ( 2 ) ), unless element-wise move assignment is forced by incompatible allocators, references, pointers, and iterators (other than the end iterator) to other remain valid, but refer to elements that are now in * this . The current standard makes this guarantee via the blanket statement in [container.reqmts]/67 , and a more direct guarantee is under consideration via LWG issue 2321 .
Example
The following code uses operator = to assign one std::unordered_set to another:
#include <initializer_list> #include <iostream> #include <iterator> #include <unordered_set> void print(const auto comment, const auto& container) { auto size = std::size(container); std::cout << comment << "{ "; for (const auto& element : container) std::cout << element << (--size ? ", " : " "); std::cout << "}\n"; } int main() { std::unordered_set<int> x{1, 2, 3}, y, z; const auto w = {4, 5, 6, 7}; std::cout << "Initially:\n"; print("x = ", x); print("y = ", y); print("z = ", z); std::cout << "Copy assignment copies data from x to y:\n"; y = x; print("x = ", x); print("y = ", y); std::cout << "Move assignment moves data from x to z, modifying both x and z:\n"; z = std::move(x); print("x = ", x); print("z = ", z); std::cout << "Assignment of initializer_list w to z:\n"; z = w; print("w = ", w); print("z = ", z); }
Possible output:
Initially:
x = { 3, 2, 1 }
y = { }
z = { }
Copy assignment copies data from x to y:
x = { 3, 2, 1 }
y = { 3, 2, 1 }
Move assignment moves data from x to z, modifying both x and z:
x = { }
z = { 3, 2, 1 }
Assignment of initializer_list w to z:
w = { 4, 5, 6, 7 }
z = { 7, 6, 5, 4 }
See also
constructs the
unordered_set
(public member function) |