(C++17) | ||||
| Sequence | ||||
(C++11) | ||||
(C++26) | ||||
(C++26) | ||||
(C++11) | ||||
| Associative | ||||
| Unordered associative | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
| Adaptors | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
| Views | ||||
(C++20) | ||||
(C++23) | ||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
std::unordered_set| Member types | ||||||
| Member functions | ||||||
| Non-member functions | ||||||
| ||||||
| Deduction guides(C++17) | ||||||
void swap( unordered_set& other); | (since C++11) (until C++17) | |
void swap( unordered_set& other)noexcept(/* see below */); | (since C++17) (constexpr since C++26) | |
Exchanges the contents of the container with those ofother. Does not invoke any move, copy, or swap operations on individual elements.
All iterators and references remain valid. Theend() iterator is invalidated.Hash andKeyEqual must beSwappable, and objects of these types are exchanged using unqualified calls to non-memberswap.Ifstd::allocator_traits<allocator_type>::propagate_on_container_swap::value istrue, then the allocators are exchanged using an unqualified call to non-memberswap. Otherwise, they are not swapped (and ifget_allocator()!= other.get_allocator(), the behavior is undefined).
Contents |
| other | - | container to exchange the contents with |
Any exception thrown by the swap of the | (until C++17) |
noexcept specification: noexcept(std::allocator_traits<Allocator>::is_always_equal::value &&std::is_nothrow_swappable<Hash>::value | (since C++17) |
Constant.
#include <iostream>#include <unordered_set> template<class Os,class Co> Os& operator<<(Os& os,const Co& co){ os<<'{';for(constauto& i: co) os<<' '<< i;return os<<" } ";} int main(){std::unordered_set<int> a1{3,1,3,2}, a2{5,4,5}; auto it1=std::next(a1.begin());auto it2=std::next(a2.begin()); constint& ref1=*(a1.begin());constint& ref2=*(a2.begin()); std::cout<< a1<< a2<<*it1<<' '<<*it2<<' '<< ref1<<' '<< ref2<<'\n'; a1.swap(a2);std::cout<< a1<< a2<<*it1<<' '<<*it2<<' '<< ref1<<' '<< ref2<<'\n'; // Note that every iterator referring to an element in one container before the swap// refers to the same element in the other container after the swap. Same is true// for references.}
Possible output:
{ 2 1 3 } { 4 5 } 1 5 2 4{ 4 5 } { 2 1 3 } 1 5 2 4| specializes thestd::swap algorithm (function template)[edit] |
