Template Function thrust::replace_if(ForwardIterator, ForwardIterator, Predicate, const T&)¶

Function Documentation¶

template<typename ForwardIterator, typename Predicate, typename T> void thrust::replace_if(ForwardIterator first, ForwardIterator last, Predicate pred, const T &new_value)

replace_if replaces every element in the range [first, last) for which pred returns true with new_value. That is: for every iterator i, if pred(*i) is true then it performs the assignment *i = new_value.

The following code snippet demonstrates how to use

replace_if to replace a device_vector's negative elements with 0.

Parameters

first: The beginning of the sequence of interest.
last: The end of the sequence of interest.
pred: The predicate to test on every value of the range [first,last).
new_value: The new value to replace elements which pred(*i) evaluates to true.

Template Parameters

ForwardIterator: is a model of Forward Iterator, ForwardIterator is mutable, and ForwardIterator's value_type is convertible to Predicate's argument_type.
Predicate: is a model of Predicate.
T: is a model of Assignable, and T is convertible to ForwardIterator's value_type.

#include <thrust/replace.h>
#include <thrust/device_vector.h>
...
struct is_less_than_zero
{
  __host__ __device__
  bool operator()(int x)
  {
    return x < 0;
  }
};

...

thrust::device_vector<int> A(4);
A[0] =  1;
A[1] = -3;
A[2] =  2;
A[3] = -1;

is_less_than_zero pred;

thrust::replace_if(A.begin(), A.end(), pred, 0);

// A contains [1, 0, 2, 0]

See: http://www.sgi.com/tech/stl/replace_if.html
See: replace
See: replace_copy
See: replace_copy_if