Next: AST_MAPSIZE - Get the number of entries in a KeyMap
Up: AST Routine Descriptions
Previous: AST_MAPREMOVE - Removed a named entry from a KeyMap
AST_MAPRENAME
-
Rename an existing KeyMap entry
- Description:
- This routine
associated a new key with an existing entry in a KeyMap. It returns
without action if the oldkey does not exist in the KeyMap.
- Invocation:
- CALL AST_MAPRENAME( THIS, OLDKEY, NEWKEY, STATUS )
- Arguments:
-
THIS = INTEGER (Given)
-
Pointer to the KeyMap.
-
OLDKEY = CHARACTER
(
) (Given)
-
The character string identifying the entry to be renamed. Trailing
spaces are ignored.
The supplied string is converted to upper case before use if the
KeyCase attribute is currently set to zero.
-
NEKEY = CHARACTER
(
) (Given)
-
The new character string to associated with the renamed 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.
Next: AST_MAPSIZE - Get the number of entries in a KeyMap
Up: AST Routine Descriptions
Previous: AST_MAPREMOVE - Removed a named entry from a KeyMap
AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk
Copyright (C) 2009 Science \& Technology Facilities Council