Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

array::swap
PrevUpHomeNext

Swap the contents.

Synopsis
void
swap(
    array& other);
Description

Exchanges the contents of this array with another array. Ownership of the respective boost::container::pmr::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.
Complexity

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

Exception Safety

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

Parameters

Name

Description

other

The value to swap with. If this == &other, this function call has no effect.


PrevUpHomeNext