string::swap

Swap the contents.

Synopsis

void
swap(
    string& other);

Description

Exchanges the contents of this string with another string. Ownership of the respective boost::container::pmr::memory_resource objects is not transferred.

  • If &other == this, do nothing. Otherwise,

  • 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. Otherwise,

  • 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() + other.size().

Exception Safety

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