swap

`swap`

Swap the given values.

void
swap(
    value& lhs,
    value& rhs);

Exchanges the contents of value lhs with another value rhs. Ownership of the respective boost::container::pmr::memory_resource objects is not transferred.

If &lhs == &rhs, this function call has no effect.
If *lhs.storage() == *rhs.storage(), ownership of the underlying memory is swapped in constant time, with no possibility of exceptions. All iterators and references remain valid.
If *lhs.storage() != *rhs.storage, the contents are logically swapped by a copy, which can throw. In this case all iterators and references are invalidated.

Constant or linear in the sum of the sizes of the values.

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

Name Description

Name	Description
`lhs`	The value to exchange.
`rhs`	The value to exchange.

lhs

The value to exchange.

rhs

The value to exchange.