ArgPutu - Put an unsigned integer item into an argument structure

Function

Put an unsigned integer item into an argument structure

Description

An unsigned integer item is written into a named component within the specified argument structure. The component is created if it does not currently exist.

Note, when this call has to create the item, it always creates 32bit unsigned integer SDS items, regardless of the size of long int on the machine. Use ArgPutui64 to create 64bit unsigned integer items.

Language

C

Declaration

void ArgPutu(SdsIdType id, const char *name, unsigned long value, const StatusType * status)

Parameters

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

>idSdsIdTypeIdentifier to the structure.
>namechar*Name of the component to be written to.
>valueunsigned longUnsigned integer value to be written.
!statusStatusType*Modified status. Possible failure codes are:

SDS__NOMEM Insufficient memory for creation
SDS__BADID Invalid Identifier
ARG__NOTSCALAR Item is not a scalar
ARG__CNVERR Type conversion error

Support

Jeremy Bailey, {AAO}

Version date

27-Mar-92

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

 For more information, contact tjf@aao.gov.au