# std::swap(std::basic_string)

> C++ Atlas: `cppatlas.com/w/cpp/string/basic_string/swap2` | Source: https://en.cppreference.com/w/cpp/string/basic_string/swap2 | Domain: Strings | Standards: C++17, C++20

Specializes the std::swap algorithm for std::basic_string. Swaps the contents of lhs and rhs.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <string>

template< class CharT, class Traits, class Alloc >
void swap( std::basic_string<CharT, Traits, Alloc>& lhs,
           std::basic_string<CharT, Traits, Alloc>& rhs ); // (until C++17)

template< class CharT, class Traits, class Alloc >
void swap( std::basic_string<CharT, Traits, Alloc>& lhs,
           std::basic_string<CharT, Traits, Alloc>& rhs ) noexcept(/* see below */); // (since C++17) (constexpr since C++20)
```

Specializes the `std::swap` algorithm for `std::basic_string`. Swaps the contents of `lhs` and `rhs`.

Equivalent to `lhs.swap(rhs)`.

### Parameters

- `lhs, rhs` - strings whose contents to swap

### Return value

(none)

### Complexity

Constant.

(since C++17):

### Exceptions

`noexcept` specification:

`noexcept(noexcept(lhs.swap(rhs)))`

### Example

```cpp
#include <iostream>
#include <string>

int main()
{
    std::string a = "AAA";
    std::string b = "BBBB";

    std::cout << "Before swap:\n"
                 "a = " << a << "\n"
                 "b = " << b << "\n\n";

    std::swap(a, b);

    std::cout << "After swap:\n"
                 "a = " << a << "\n"
                 "b = " << b << '\n';
}
```

Output:

```text
Before swap:
a = AAA
b = BBBB

After swap:
a = BBBB
b = AAA
```

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

| DR | Applied to | Behavior as published | Correct behavior |
| --- | --- | --- | --- |
| LWG 2064 | C++11 | non-member `swap` was noexcept and inconsistent with member `swap` | noexcept removed |

### See also

- [`swap`](https://en.cppreference.com/w/cpp/string/basic_string/swap): swaps the contents (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/basic_string/swap2 (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.