# std::swap(std::basic_spanbuf)

> C++ Atlas: `cppatlas.com/w/cpp/io/basic_spanbuf/swap2` | Source: https://en.cppreference.com/w/cpp/io/basic_spanbuf/swap2 | Domain: Input/output | Standards: C++23

Overloads the std::swap algorithm for std::basic_spanbuf. Exchanges the state of lhs with that of rhs. Equivalent to lhs.swap(rhs);.

## Official Specification Summary (cppreference)

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

template< class CharT, class Traits >
void swap( std::basic_spanbuf<CharT, Traits>& lhs,
           std::basic_spanbuf<CharT, Traits>& rhs ); // (since C++23)
```

Overloads the `std::swap` algorithm for `std::basic_spanbuf`. Exchanges the state of `lhs` with that of `rhs`. Equivalent to `lhs.swap(rhs);`.

### Parameters

- `lhs, rhs` - `std::basic_spanbuf` objects whose states to swap

### Return value

(none)

### Exceptions

May throw implementation-defined exceptions.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`swap`](https://en.cppreference.com/w/cpp/io/basic_spanbuf/swap): swaps two `basic_spanbuf` objects (public member function)
- [`swap`](https://en.cppreference.com/w/cpp/algorithm/swap): swaps the values of two objects (function template)

---
Attribution: content from https://en.cppreference.com/w/cpp/io/basic_spanbuf/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.