SdsInsertCell - Insert object into a structure array

Function

Insert object into a structure array

Description

Insert a top level object into a structure array at a position specified by its indices. Delete any object that is currently at that position.

Language

C

Declaration

void SdsInsertCell(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 1 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.
>idSdsIdTypeThe identifier of the component to be inserted.
!statusStatusType*Modified status. Possible failure codes are:

SDS__EXTERN Structure array or object is external.
SDS__NOTARRAY Not a structure array.
SDS__INDEXERR Indices invalid.
SDS__NOTTOP Not a top level object.

Support

Jeremy Bailey, {AAO}

Version date

24-Aug-96

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

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