AST_MAPLENGTH

Get the vector length of an entry in a KeyMap

Description:

This function returns the vector length of a named entry in a KeyMap, (that is, how many values are associated with the entry).

Invocation

RESULT = AST_MAPLENGTH( THIS, KEY, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the KeyMap.
KEY = CHARACTER ∗ ( ∗ ) (Given)
The character string identifying the KeyMap entry. 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_MAPLENGTH = INTEGER
The length of the entry. One for a scalar, greater than one for a vector. A value of zero is returned if the KeyMap does not contain the named entry.

Notes:

Copyright (C) 2021 East Asian Observatory