Function template reduce

hpx::lcos::reduce — Perform a distributed reduction operation.

Synopsis

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


template<typename Action, typename ReduceOp, typename ArgN, ... > 
  hpx::future< decltype(Action(hpx::id_type, ArgN,...))> 
  reduce(std::vector< hpx::id_type > const & ids, ReduceOp && reduce_op, 
         ArgN argN, ...);

Description

The function hpx::lcos::reduce performs a distributed reduction operation over results returned from action invocations on a given set of global identifiers. The action can be either a plain action (in which case the global identifiers have to refer to localities) or a component action (in which case the global identifiers have to refer to instances of a component type which exposes the action.

Parameters:

`argN`	[in] Any number of arbitrary arguments (passed by by const reference) which will be forwarded to the action invocation.
`ids`	[in] A list of global identifiers identifying the target objects for which the given action will be invoked.
`reduce_op`	[in] A binary function expecting two results as returned from the action invocations. The function (or function object) is expected to return the result of the reduction operation performed on its arguments.

Returns:

This function returns a future representing the result of the overall reduction operation.