# std::suspend_always

> C++ Atlas: `cppatlas.com/w/cpp/coroutine/suspend_always` | Source: https://en.cppreference.com/w/cpp/coroutine/suspend_always | Domain: Coroutine support | Standards: C++20

suspend_always is an empty class which can be used to indicate that an await expression always suspends and does not produce a value.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <coroutine>
struct suspend_always; // (since C++20)
```

`suspend_always` is an empty class which can be used to indicate that an await expression always suspends and does not produce a value.

#### Member functions

- `await_ready`: indicates that an await expression always suspends (public member function)
- `await_suspend`: no-op (public member function)
- `await_resume`: no-op (public member function)

### std::suspend_always::await_ready

```cpp
constexpr bool await_ready() const noexcept { return false; }
```

Always returns `false`, indicating that an await expression always suspends.

### std::suspend_always::await_suspend

```cpp
constexpr void await_suspend( std::coroutine_handle<> ) const noexcept {}
```

Does nothing.

### std::suspend_always::await_resume

```cpp
constexpr void await_resume() const noexcept {}
```

Does nothing. An await expression does not produce a value if `suspend_always` is used.

#### Example

> Note: This section is incomplete Reason: no example

#### See also

- [`suspend_never`](https://en.cppreference.com/w/cpp/coroutine/suspend_never) (C++20): indicates that an await-expression should never suspend (class)

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