(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::map
Member functions | |||||||
Non-member functions | |||||||
| |||||||
Deduction guides(C++17) |
void swap( map& other); | (until C++17) | |
void swap( map& 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.Compare
must beSwappable, and objects of this type are exchanged using unqualified call 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-member | (since C++11) |
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<Compare>::value) | (since C++17) |
Constant.
#include <iostream>#include <string>#include <utility>#include <map> // print out a std::pairtemplate<class Os,class U,class V>Os& operator<<(Os& os,conststd::pair<U, V>& p){return os<< p.first<<':'<< p.second;} // print out a containertemplate<class Os,class Co>Os& operator<<(Os& os,const Co& co){ os<<'{';for(constauto& i: co) os<<' '<< i;return os<<" }\n";} int main(){std::map<std::string,std::string> m1{{"γ","gamma"},{"β","beta"},{"α","alpha"},{"γ","gamma"}}, m2{{"ε","epsilon"},{"δ","delta"},{"ε","epsilon"}}; constauto& ref=*(m1.begin());constauto iter=std::next(m1.cbegin()); std::cout<<"──────── before swap ────────\n"<<"m1: "<< m1<<"m2: "<< m2<<"ref: "<< ref<<"\niter: "<<*iter<<'\n'; m1.swap(m2); std::cout<<"──────── after swap ────────\n"<<"m1: "<< m1<<"m2: "<< m2<<"ref: "<< ref<<"\niter: "<<*iter<<'\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.}
Output:
──────── before swap ────────m1: { α:alpha β:beta γ:gamma }m2: { δ:delta ε:epsilon }ref: α:alphaiter: β:beta──────── after swap ────────m1: { δ:delta ε:epsilon }m2: { α:alpha β:beta γ:gamma }ref: α:alphaiter: β:beta
specializes thestd::swap algorithm (function template)[edit] |