# std::experimental::swap(std::experimental::optional)

> C++ Atlas: `cppatlas.com/w/cpp/experimental/optional/swap2` | Source: https://en.cppreference.com/w/cpp/experimental/optional/swap2 | Domain: Technical specifications

Overloads the std::swap algorithm for std::experimental::optional. Exchanges the state of lhs with that of rhs. Effectively calls lhs.swap(rhs).

## Official Specification Summary (cppreference)

```cpp
// Defined in header <experimental/optional>

template< class T >
void swap( optional<T>& lhs, optional<T>& rhs ) noexcept(/* see below */); // (library fundamentals TS)
```

Overloads the `std::swap` algorithm for `std::experimental::optional`. Exchanges the state of `lhs` with that of `rhs`. Effectively calls `lhs.swap(rhs)`.

### Parameters

- `lhs, rhs` - `optional` objects whose states to swap

### Return value

(none)

### Exceptions

`noexcept` specification:

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

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`swap`](https://en.cppreference.com/w/cpp/experimental/optional/swap): exchanges the contents (public member function)

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