ArgPut1DArrayIElem - Put a 1D INT32 array element.

Function

Put a 1D INT32 array element.

Put an element 1D INT32 array item into an ARG structure. The item is created if it does not exist.

Does not convert items like the other Arg routines - if the item already exists it must be at least as long as required and of the same type.

void ArgPut1DArrayIElem(id, name, dim, index, data, status)

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

>	id	SdsIdType	Identifier to the structure.
>	name	char*	Name of the component to be written to.
>	dim	long	Number of elements in array. If array does not already exist, it will be created with this number of elements. If it does exist, it must have at least this number of elements. If zero, use index+1.
>	index	unsigned int	Index of item to be inserted.
>	data	`INT32`	The data to be inserted.
`!`	status	StatusType*	Modified status. Possible failure codes are:

`SDS__NOMEM`	Insufficient memory for creation
`SDS__BADID`	Invalid Identifier
`SDS__INVDIMS`	Item exists but it not a 1 D array or is 1 D but has less then "dim" elements. Or index is greater then dim-1.
`SDS__INVTYPE`	Item exists but it not of type `SDS_DOUBLE`.

Tony Farrell, {AAO}

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

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