CL-generate

Functions
template<typename ForwardIterator , typename Generator >
void	bolt::cl::generate (bolt::cl::control &ctl, ForwardIterator first, ForwardIterator last, Generator gen, const std::string &cl_code="")
	generate assigns to each element of a sequence [first,last] the value returned by gen.
template<typename ForwardIterator , typename Generator >
void	bolt::cl::generate (ForwardIterator first, ForwardIterator last, Generator gen, const std::string &cl_code="")
template<typename OutputIterator , typename Size , typename Generator >
OutputIterator	bolt::cl::generate_n (bolt::cl::control &ctl, OutputIterator first, Size n, Generator gen, const std::string &cl_code="")
	generate_n assigns to each element of a sequence [first,first+n] the value returned by gen.
template<typename OutputIterator , typename Size , typename Generator >
OutputIterator	bolt::cl::generate_n (OutputIterator first, Size n, Generator gen, const std::string &cl_code="")

Detailed Description

Function Documentation

template<typename ForwardIterator , typename Generator >

void bolt::cl::generate	(	bolt::cl::control &	ctl,
		ForwardIterator	first,
		ForwardIterator	last,
		Generator	gen,
		const std::string &	cl_code = ""
	)

generate assigns to each element of a sequence [first,last] the value returned by gen.

Parameters

ctl	Optional control structure to control command-queue, debug, tuning, etc. See bolt::cl::control.
first	The first element of the sequence.
last	The last element of the sequence.
gen	A generator, functor taking no parameters.
cl_code	Optional OpenCL(TM) code to be prepended to any OpenCL kernels used by this function.

Template Parameters

ForwardIterator	is a model of Forward Iterator, and ForwardIterator is mutable.
Generator	is a model of Generator, and Generator's result_type is convertible to ForwardIterator's value_type.

The following code snippet demonstrates how to fill a vector with a constant number.

#include <bolt/cl/generate.h>
#include <bolt/cl/device_vector.h>
#include <stdlib.h>
...

BOLT_FUNCTOR(ConstFunctor,
struct ConstFunctor
{
    int val;
    ConstFunctor(int a) : val(a) {};

    int operator() ()
    {
        return val;
    };
};
);
...

ConstFunctor cf(1);
std::vector<int> vec(1024);
bolt::cl::generate( vec.begin(), vec.end(), cf);

// vec is now filled with 1

See Also

http://www.sgi.com/tech/stl/generate.html

template<typename OutputIterator , typename Size , typename Generator >

OutputIterator bolt::cl::generate_n	(	bolt::cl::control &	ctl,
		OutputIterator	first,
		Size	n,
		Generator	gen,
		const std::string &	cl_code = ""
	)

generate_n assigns to each element of a sequence [first,first+n] the value returned by gen.

Parameters

ctl	Optional control structure to control command-queue, debug, tuning, etc. See bolt::cl::control.
first	The first element of the sequence.
n	The number of sequence elements to generate.
gen	A generator, functor taking no parameters.
cl_code	Optional OpenCL(TM) code to be prepended to any OpenCL kernels used by this function.

Template Parameters

OutputIterator	is a model of Output Iterator.
Size	is an integral type.
Generator	is a model of Generator, and Generator's result_type is convertible to OutputIterator's value_type.

The following code snippet demonstrates how to fill a vector with a constant number.

#include <bolt/cl/generate.h>
#include <bolt/cl/bolt.h>
#include <stdlib.h>
...

BOLT_FUNCTOR(ConstFunctor,
struct ConstFunctor
{
    int val;
    ConstFunctor(int a) : val(a) {};

    int operator() ()
    {
        return val;
    };
};
);
...

ConstFunctor cf(1);
std::vector<int> vec(1024);
int n = 1024;
bolt::cl::generate_n(vec.begin(), n, cf);

// vec is now filled with 1

See Also

http://www.sgi.com/tech/stl/generate_n.html