# std::execution::upon_stopped

> C++ Atlas: `cppatlas.com/w/cpp/execution/upon_stopped` | Source: https://en.cppreference.com/w/cpp/execution/upon_stopped | Domain: Execution | Standards: C++26

Returns a sender describing the task graph described by the input sender, with an added node of invoking the provided function in case the "stopped" signal is sent to the input sender.

## Official Specification Summary (cppreference)

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

execution::sender auto upon_stopped( execution::sender auto input,
                                     std::invocable auto function ); // (since C++26)
```

### Parameters

- `input` - sender which once gets "stop token", will notify the new node to execute the function
- `function` - invocable to be called in case a "stopped" signal is sent to the input sender

### Return value

Returns a sender describing the task graph described by the input sender, with an added node of invoking the provided function in case the "stopped" signal is sent to the input sender.

### Example

> Note: This section is incomplete Reason: no example

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