# std::coroutine_handle<Promise>::destroy

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

The behavior is undefined if destroying is needed and *this does not refer to a suspended coroutine.

## Official Specification Summary (cppreference)

```cpp
// Member of other specializations
void destroy() const; // (1) (since C++20)
// Member of specialization std::coroutine_handle<std::noop_coroutine_promise>
constexpr void destroy() const noexcept; // (2) (since C++20)
```

1) Destroys the coroutine state of the coroutine to which `*this` refers, or does nothing if the coroutine is a no-op coroutine.

2) Does nothing.

The behavior is undefined if destroying is needed and `*this` does not refer to a suspended coroutine.

### Parameters

(none)

### Return value

(none)

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`operator()`](https://en.cppreference.com/w/cpp/coroutine/coroutine_handle/resume), [`resume`](https://en.cppreference.com/w/cpp/coroutine/coroutine_handle/resume): resumes execution of the coroutine (public member function)

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