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).

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

THIS = INTEGER (Given)

KEY = CHARACTER $\ast$ ( $\ast$ ) (Given)

VALUE = $<$X$>$type (Given)

COMMENT = CHARACTER $\ast$ ( $\ast$ ) (Given)

STATUS = INTEGER (Given and Returned)

• If the supplied key is already in use in the KeyMap, the new value will replace the old value.

• If the stored value is an AST Object pointer, the Object’ s reference count is incremented by this call. Any subsequent changes made to the Object using the returned pointer will be reflected in any any other active pointers for the Object, including any obtained later using AST_MAPGET0A. The reference count for the Object will be decremented when the KeyMap is destroyed, or the entry is removed or over-written with a different pointer.

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:

• D: DOUBLE PRECISION

• R: REAL

• I: INTEGER

• K: INTEGER$\ast$8

• C: CHARACTER

• A: INTEGER used to identify an AstObject

• S: INTEGER$\ast$2 (short integer)

• B: Unsigned byte

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