Public Member Functions

vector_iterator< SCALARTYPE, ALIGNMENT > Class Template Reference

A STL-type iterator for vector elements. Elements can be accessed and manipulated. VERY SLOW!! More...

#include <vector.hpp>

Inheritance diagram for vector_iterator< SCALARTYPE, ALIGNMENT >:
const_vector_iterator< SCALARTYPE, ALIGNMENT >

Public Member Functions

 vector_iterator ()
 vector_iterator (viennacl::ocl::handle< cl_mem > const &elements, std::size_t index)
 vector_iterator (vector< SCALARTYPE, ALIGNMENT > &vec, cl_uint index)
 Constructor.
 vector_iterator (base_type const &b)
base_type::value_type operator* (void)
viennacl::ocl::handle< cl_mem > handle ()
 operator base_type () const

Detailed Description

template<class SCALARTYPE, unsigned int ALIGNMENT>
class viennacl::vector_iterator< SCALARTYPE, ALIGNMENT >

A STL-type iterator for vector elements. Elements can be accessed and manipulated. VERY SLOW!!

Every dereference operation initiates a transfer from the GPU to the CPU. The overhead of such a transfer is around 50us, so 20.000 dereferences take one second. This is four orders of magnitude slower than similar dereferences on the CPU. However, increments and comparisons of iterators is as fast as for CPU types. If you need a fast iterator, copy the whole vector to the CPU first and iterate over the CPU object, e.g. std::vector<float> temp; copy(gpu_vector, temp); for (std::vector<float>::const_iterator iter = temp.begin(); iter != temp.end(); ++iter) { //do something } copy(temp, gpu_vector); Note that you may obtain inconsistent data if you manipulate entries of gpu_vector in the meanwhile.

Template Parameters:
SCALARTYPE The underlying floating point type (either float or double)
ALIGNMENT Alignment of the underlying vector,
See also:
vector

Constructor & Destructor Documentation

vector_iterator (  )  [inline]
vector_iterator ( viennacl::ocl::handle< cl_mem > const &  elements,
std::size_t  index 
) [inline]
vector_iterator ( vector< SCALARTYPE, ALIGNMENT > &  vec,
cl_uint  index 
) [inline]

Constructor.

Parameters:
vec The vector over which to iterate
index The starting index of the iterator
vector_iterator ( base_type const &  b  )  [inline]

Member Function Documentation

viennacl::ocl::handle<cl_mem> handle (  )  [inline]
operator base_type (  )  const [inline]
base_type::value_type operator* ( void   )  [inline]

The documentation for this class was generated from the following file: