HPX - High Performance ParalleX

PrevUpHomeNext

Function template when_each

hpx::when_each

Synopsis

// In header: <hpx/lcos/when_each.hpp>


template<typename F, typename Future> 
  future< void > when_each(F && f, std::vector< Future > && futures);

Description

The function when_each is a operator allowing to join on the results of all given futures. It AND-composes all future objects given and returns a new future object representing the event of all those futures having finished executing. It also calls the supplied callback for each of the futures which becomes ready.

[Note] Note

This function consumes the futures as they are passed on to the supplied function.

Parameters:

f

The function which will be called for each of the input futures once the future has become ready.

futures

A vector holding an arbitrary amount of future or shared_future objects for which wait_each should wait.

Returns:

Returns a future representing the event of all input futures being ready.


PrevUpHomeNext