next up previous 264
Next: astMapSize - Get the number of entries in a KeyMap
Up: AST Function Descriptions
Previous: astMapRemove - Removed a named entry from a KeyMap


astMapRename - Rename an existing KeyMap entry

Description:
This function associated a new key with an existing entry in a KeyMap. It returns without action if the oldkey does not exist in the KeyMap.
Synopsis:
void astMapRename( AstKeyMap $*$this, const char $*$oldkey, const char $*$newkey )
Parameters:
this
Pointer to the KeyMap.
oldkey
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.
newkey
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.


next up previous 264
Next: astMapSize - Get the number of entries in a KeyMap
Up: AST Function Descriptions
Previous: astMapRemove - Removed a named entry from a KeyMap

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 211
R.F. Warren-Smith & D.S. Berry
7th December 2012
E-mail:starlink@jiscmail.ac.uk

Copyright (C) 2012 Science \& Technology Facilities Council