std::array<T,N>::swap - cppreference.com (original) (raw)

| void swap( array& other ) noexcept(/* see below */); | | (since C++11) (constexpr since C++20) | | ------------------------------------------------------ | | ------------------------------------- |

Exchanges the contents of the container with those of other. Does not cause iterators and references to associate with the other container.

Contents

• 1 Parameters
• 2 Return value
• 3 Exceptions
• 4 Complexity
• 5 Example
• 6 Defect reports
• 7 See also

[edit] Parameters

[edit] Return value

(none)

[edit] Exceptions

For zero-sized arrays,

[edit] Complexity

Linear in size of the container.

[edit] Example

#include #include   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 2

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

[edit] See also