# std::execution::upon_error

> C++ Atlas: `cppatlas.com/w/cpp/execution/upon_error` | Source: https://en.cppreference.com/w/cpp/execution/upon_error | 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 with the errors sent by the input sender as arguments (in case of an error).

## Official Specification Summary (cppreference)

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

execution::sender auto
    upon_error( execution::sender auto input,
                std::invocable</*errors-sent-by*/(input)...> function ); // (since C++26)
```

### Parameters

- `input` - sender which once an error occurs, sends the errors to the function
- `function` - invocable to be called with errors in case an error occurs by 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 with the errors sent by the input sender as arguments (in case of an error).

### Example

> Note: This section is incomplete Reason: no example

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