AST_MAPPUT0 <X >

Add a scalar value to a KeyMap

Description:

This is a set of routine for adding scalar values to a KeyMap. You should use a routine which matches the data type of the data you wish to add to the KeyMap by replacing <X > in the generic routine name AST_MAPPUT0 <X > by an appropriate 1-character type code (see the " Data Type Codes" section below for the code appropriate to each supported data type).

Invocation

CALL AST_MAPPUT0 <X >( THIS, KEY, VALUE, COMMENT, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the KeyMap in which to store the supplied value.
KEY = CHARACTER ( ) (Given)
A character string to be stored with the value, which can later be used to identify the value. Trailing spaces are ignored. The supplied string is converted to upper case before use if the KeyCase attribute is currently set to zero.
VALUE = <X >type (Given)
The value to be stored. The data type of this value should match the 1-character type code appended to the routine name (e.g. if you are using AST_MAPPUT0A, the type of this value should be " integer pointer for an AstObject" ).
COMMENT = CHARACTER ( ) (Given)
A comment string to be stored with the value.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:

Data Type Codes

To select the appropriate routine, you should replace <X > in the generic routine name AST_MAPPUT0 <X > with a 1-character data type code, so as to match the data type <X >type of the data you are processing, as follows:

For example, AST_MAPPUT0D would be used to store a DOUBLE PRECISION value, while AST_MAPPUT0I would be used to store an INTEGER, etc.