| Home | Libraries | People | FAQ | More

###### array::swap (2 of 2 overloads)

Swap the contents.

<h7> Synopsis </h7>

    void
    swap(
        array& other);

<h7> Description </h7>

Exchanges the contents of this array with another array. Ownership of the respective `memory_resource` objects is not transferred.

- If `*other.storage() == *this->storage()`, ownership of the underlying memory is swapped in constant time, with no possibility of exceptions. All iterators and references remain valid.
- If `*other.storage() != *this->storage()`, the contents are logically swapped by making copies, which can throw. In this case all iterators and references are invalidated.

<h7> Complexity </h7>

Constant or linear in `size()` plus `other.size()`.

<h7> Exception Safety </h7>

Strong guarantee. Calls to `memory_resource::allocate` may throw.

<h7> Parameters </h7>

Name | Description
--- | ---
`other` | The value to swap with. If `this == &other`, this function call has no effect.