ArrayAccess() [4/4]

template<typename T >

void drama::sds::Id::ArrayAccess ( const unsigned long  nitems, sds::ArrayAccessHelper< T > *const  data  ) const

inline

Access the data of a single dimensional SDS primitive item array of a specified number of elements.

Accesses an array using an ArrayWriteHelper or ArrayReadHelper of the appropriate type.
This version allows access to a one dimensional array of any size. Various other versions also exist.

On return, "data[index]" can be used to access the array element at the specified index.

In this version uses the number of elements in the SDS array must match the specified number of elements.

In this example, we instantiate value to provide access to an array of 10 SDS short items.

   sds::Id structure;
   ...
   sds::ArrayReadHelper<short> value;
   structure.ArrayAccess(10, &value);
   for (unsigned long i = 0; i < 10 ; ++i)
      printf("Element %ld = %d\\n", i, (int)value[i]);

• See also

  sds::ArrayAccessHelper

  sds::ArrayWriteHelper

  sds::ArrayReadHelper

  Parameters

  nitems	The number of items expected in the array.
  data	A pointer to an object which allows you to access the underlying SDS data. It must be an Instantiations of a sub-class of ArrayAccessHelper appropriate for type T.

  Template Parameters

  T	The array access helper to use.

References drama::sds::ArrayAccessHelper< T >::Code(), drama::CreateRunDramaTask(), and DramaTHROW_F.