AST_MAPDEFINED

Check if a KeyMap contains a defined value for a key

Description:

This function checks to see if a KeyMap contains a defined value for a given key. If the key is present in the KeyMap but has an undefined value it returns .FALSE. (unlike AST_MAPHASKEY which would return .TRUE.).

Invocation

RESULT = AST_MAPDEFINED( THIS, KEY, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the KeyMap.
KEY = CHARACTER ∗ ( ∗ ) (Given)
The character string identifying the value to be retrieved. Trailing spaces are ignored. The supplied string is converted to upper case before use if the KeyCase attribute is currently set to zero.
STATUS = INTEGER (Given and Returned)
The global status.

Returned Value

AST_MAPDEFINED = LOGICAL
.TRUE. is returned if the requested key name is present in the KeyMap and has a defined value.
Copyright (C) 2021 East Asian Observatory