...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Swap two objects.
Defined in header <boost/json/object.hpp>
friend void swap( object& lhs, object& rhs);
Exchanges the contents of the object lhs
with another object rhs
.
Ownership of the respective memory_resource
objects is not
transferred.
*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.
*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.
lhs.swap( rhs );
Constant or linear in lhs.size() + rhs.size()
.
Strong guarantee. Calls to memory_resource::allocate
may throw.
Name |
Description |
---|---|
|
The object to exchange. |
|
The object to exchange. If |
Convenience header <boost/json.hpp>