next up previous 264
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 up previous 264
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