# std::expected<T,E>::error_or

> C++ Atlas: `cppatlas.com/w/cpp/utility/expected/error_or` | Source: https://en.cppreference.com/w/cpp/utility/expected/error_or | Domain: Utility | Standards: C++23

Returns the unexpected value if it exists, otherwise returns default_value.

## Official Specification Summary (cppreference)

```cpp
template< class G = E >
constexpr E error_or( G&& default_value ) const&; // (1) (since C++23)

template< class G = E >
constexpr E error_or( G&& default_value ) &&; // (2) (since C++23)
```

Returns the unexpected value if it exists, otherwise returns `default_value`.

1) If `std::is_copy_constructible_v<E>` or `std::is_convertible_v<G, E>` is `false`, the program is ill-formed.

2) If `std::is_move_constructible_v<E>` or `std::is_convertible_v<G, E>` is `false`, the program is ill-formed.

### Parameters

- `default_value` - the value to use in case `*this` does not contain an unexpected value

**Type requirements**

### Return value

1) `has_value() ? std::forward<G>(default_value): error()`

2) `has_value() ? std::forward<G>(default_value): std::move(error())`

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`error`](https://en.cppreference.com/w/cpp/utility/expected/error): returns the unexpected value (public member function)

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