Next: astMapPut0X - Add a scalar value to a KeyMap
Up: AST Function Descriptions
Previous: astMapLenC - Get the number of characters in a character entry in a KeyMap
astMapLength
-
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).
- Synopsis:
- int astMapLength( AstKeyMap
this, const char
key )
- Parameters:
-
this
-
Pointer to the KeyMap.
-
key
-
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.
- Returned Value:
-
astMapLength()
-
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:
- A function value of zero will be returned if an error has already
occurred, or if this function should fail for any reason.
Next: astMapPut0X - Add a scalar value to a KeyMap
Up: AST Function Descriptions
Previous: astMapLenC - Get the number of characters in a character entry in a KeyMap
AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council