array::swap
Exchange the given values.
Synopsis
Defined in header <boost/json/array.hpp>.
Description
Exchanges the contents of the array lhs with another array rhs. Ownership of the respective boost::container::pmr::memory_resource objects is not transferred.
-
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 making a copy, which can throw. In this case all iterators and references are invalidated.
Effects
lhs.swap( rhs );Complexity
Constant or linear in lhs.size() + rhs.size().
Exception Safety
Strong guarantee. Calls to memory_resource::allocate may throw.
Parameters
| Name | Description |
|---|---|
|
The array to exchange. |
|
The array to exchange. If |
See Also
Convenience header <boost/json.hpp>