(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 |
| Member types | ||||||
| Member functions | ||||||
| Non-member functions | ||||||
| ||||||
| Helper classes | ||||||
| Deduction guides(C++17) | ||||||
void swap( array& other)noexcept(/* see below */); | (since C++11) (constexpr since C++20) | |
Exchanges the contents of the container with those ofother. Does not cause iterators and references to associate with the other container.
Contents |
| other | - | container to exchange the contents with |
(none)
noexcept specification: noexcept(noexcept(swap(std::declval<T&>(),std::declval<T&>()))) In the expression above, the identifier | (until C++17) |
noexcept specification: noexcept(std::is_nothrow_swappable_v<T>) | (since C++17) |
Linear in size of the container.
#include <array>#include <iostream> template<class Os,class V> Os& operator<<(Os& os,const V& v){ os<<'{';for(auto i: v) os<<' '<< i;return os<<" } ";} int main(){std::array<int,3> a1{1,2,3}, a2{4,5,6}; auto it1= a1.begin();auto it2= a2.begin();int& ref1= a1[1];int& ref2= a2[1]; std::cout<< a1<< a2<<*it1<<' '<<*it2<<' '<< ref1<<' '<< ref2<<'\n'; a1.swap(a2);std::cout<< a1<< a2<<*it1<<' '<<*it2<<' '<< ref1<<' '<< ref2<<'\n'; // Note that after swap iterators and references stay associated with their original// array, e.g. `it1` still points to element a1[0], `ref1` still refers to a1[1].}
Output:
{ 1 2 3 } { 4 5 6 } 1 4 2 5{ 4 5 6 } { 1 2 3 } 4 1 5 2The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 2456 | C++11 | thenoexcept specification is ill-formed | made to work |
(C++11) | specializes thestd::swap algorithm (function template)[edit] |
