AST_MAPPUTU

Add an entry to a KeyMap with an undefined value

Description:

This routine adds a new entry to a KeyMap, but no value is stored with the entry. The entry therefore has a special data type represented by symbolic constant AST__UNDEFTYPE.

An example use is to add entries with undefined values to a KeyMap prior to locking them with the MapLocked attribute. Such entries can act as placeholders for values that can be added to the KeyMap later.

Invocation

CALL AST_MAPPUTU( THIS, KEY, 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.
COMMENT = CHARACTER ( ) (Given)
A comment string to be stored with the value.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: