SdsCell - Find component of a structure array

Function

Find component of a structure array

Description

Given the indices to a component of a structure array, return an identifier to the component.

Language

C

Declaration

void SdsCell(SdsIdType array_id, long nindices, unsigned long *indices, SdsIdType *id, StatusType * SDSCONST status)

Parameters

(">" input, "!" modified, "W" workspace, "<" output)

>array_idSdsIdTypeIdentifier of the structure array.
>nindiceslongNumber of indices supplied in the array indices. This should be one or the same as the number of dimensions of the array.
>indicesunsigned long*An array of length nindices containing the indices to the component of the structure array. If nindicies is 1, then treat the structure array as having only one dimension even if it has more.
<idSdsIdType*The identifier of the component.
!statusStatusType*Modified status. Possible failure codes are:

SDS__NOMEM Insufficient memory for creation
SDS__NOTARRAY Not a structure array.
SDS__INDEXERR Indices invalid.

Support

Jeremy Bailey, {AAO}

Version date

18-Oct-91

Click here for the DRAMA home page and here for the AAO home page.

 For more information, contact tony.farrell@mq.edu.au