◆ transform_exclusive_scan() [2/2]

template<typename InputIterator , typename OutputIterator , typename UnaryFunction , typename T , typename AssociativeOperator >
OutputIterator thrust::transform_exclusive_scan ( InputIterator  first,
InputIterator  last,
OutputIterator  result,
UnaryFunction  unary_op,
AssociativeOperator  binary_op 

transform_exclusive_scan fuses the transform and exclusive_scan operations. transform_exclusive_scan is equivalent to performing a tranformation defined by unary_op into a temporary sequence and then performing an exclusive_scan on the tranformed sequence. In most cases, fusing these two operations together is more efficient, since fewer memory reads and writes are required. In transform_exclusive_scan, init is assigned to *result and the result of binary_op(init, unary_op(*first)) is assigned to *(result + 1), and so on. The transform scan operation is permitted to be in-place.

firstThe beginning of the input sequence.
lastThe end of the input sequence.
resultThe beginning of the output sequence.
unary_opThe function used to tranform the input sequence.
initThe initial value of the exclusive_scan
binary_opThe associatve operator used to 'sum' transformed values.
The end of the output sequence.
Template Parameters
InputIteratoris a model of Input Iterator and InputIterator's value_type is convertible to unary_op's input type.
OutputIteratoris a model of Output Iterator.
UnaryFunctionis a model of Unary Function and accepts inputs of InputIterator's value_type. UnaryFunction's result_type is convertable to OutputIterator's value_type.
Tis convertible to OutputIterator's value_type.
AssociativeOperatoris a model of Binary Function and AssociativeOperator's result_type is convertible to OutputIterator's value_type.
first may equal result, but the range [first, last) and the range [result, result + (last - first)) shall not overlap otherwise.

The following code snippet demonstrates how to use transform_exclusive_scan

int data[6] = {1, 0, 2, 2, 1, 3};
thrust::transform_exclusive_scan(data, data + 6, data, unary_op, 4, binary_op); // in-place scan
// data is now {4, 3, 3, 1, -1, -2}
See also