object::swap
Swap two objects.
Synopsis
void
swap(
object& other);Description
Exchanges the contents of this object with another object. Ownership of the respective boost::container::pmr::memory_resource objects is not transferred. If this == &other, this function call has no effect.
-
If
*storage() == *other.storage()all iterators and references remain valid. -
Otherwise, the contents are logically swapped by making copies, which can throw. In this case all iterators and references are invalidated.
Complexity
If *storage() == *other.storage(), then constant; otherwise linear in size() + other.size().
Exception Safety
No-throw guarantee if *storage() == *other.storage(). Otherwise strong guarantee. Calls to memory_resource::allocate may throw.
Parameters
| Name | Description |
|---|---|
|
The object to swap with. |