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

Declaration

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

Parameters

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

>	id	SdsIdType	Identifier to the structure.
>	name	char*	Name of the component to be written to.
>	value	unsigned long	Unsigned integer value to be written.
`!`	status	StatusType*	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 tony.farrell@mq.edu.au