◆ ArrayAccess() [3/4]

template<typename T >

void SdsId::ArrayAccess	(	SdsArrayAccessHelper< T > *const	data,
		long	ndims,
		unsigned long	dims[],
		StatusType *const	status
	)

inline

Access the data of an SDS array.

Accesses an array using an SdsArrayAccessHelper of the appropiate type. This version allows access to an array of a specified number of dimensions. Various other versions also exist.

On return, "data[index]" can be used to access the array element at the specified index. See the SdsArrayAccessHelper:: class for more information. Note that Multidimensional arrays must be indexed by calculating the equivalent single dimensional index (otherwise the type definitions are too hard).

In this example, SdsArrayShort is a sub-class of SdsArrayAccessHelper.

   SdsId structure;
   ...
   unsigned long dims[SDS_C_MAXARRAYDIMS];
   SdsArrayShort value;
   structure.ArrayAccess(&value, 1, dims, status);
   if (*status == STATUS__OK)
   {
      for (unsigned long i = 0; i < dims[0] ; ++i)
        printf("Element %ld = %d\\n", i, (int)value[i]);
   }

Remarks: Only available if the marcro DRAMA_ALLOW_CPP_STDLIB is defined.

See also: SdsArrayAccessHelper

Parameters

data	A pointer to an object which allows you to access the underlying SDS data. It must be a sub-class of SdsArrayAccessHelper appropiate for type T.
ndims	The number of dimensions there should be in the structure.
dims	The dimensions are written to this array. Must have space for 7 dimensions.
status	Inherited status. In addition to the values returned by SdsInfo() and SdsPointer(), the values SDS__TYPE, SDS__NOTARR and SDS__INVDIMS may be returned.

References SdsArrayAccessHelper< T >::Code().