# std::execution::then

> C++ Atlas: `cppatlas.com/w/cpp/execution/then` | Source: https://en.cppreference.com/w/cpp/execution/then | 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 values sent by the input sender as arguments.

## Official Specification Summary (cppreference)

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

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

### Parameters

- `input` - sender which once executed sends the values upon which the function executes
- `function` - invocable to be called by the new sender chained 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 with the values sent by the input sender as arguments.

`then` is guaranteed to not begin executing function until the returned sender is started.

### Example

Possible usage of `execution::then`.

```cpp
execution::sender auto input = get_input();
execution::sender auto snd = execution::then(input, [](auto... args)
{
    std::print(args...);
});
// snd describes the work described by pred
// followed by printing all of the values sent by pred
```

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