next up previous 264
Next: astMapKey - Get the key at a given index within the KeyMap
Up: AST Function Descriptions
Previous: astMapGetElemX - Get a single element of a vector value from a KeyMap


astMapHasKey - Check if an entry with a given key exists in a KeyMap

Description:
This function returns a flag indicating if the KeyMap contains an entry with the given key.
Synopsis:
int astMapHasKey( 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:
astMapHasKey()
Non-zero if the key was found, and zero otherwise.
Notes:
  • A non-zero function value is returned if the key exists but has an undefined value (that is, the returned value does not depend on whether the entry has a defined value or not).

  • 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: astMapKey - Get the key at a given index within the KeyMap
Up: AST Function Descriptions
Previous: astMapGetElemX - Get a single element of a vector value from 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