- ←Prev
- AST
A Library for Handling
World Coordinate Systems
in Astronomy - Next→
- TOC ↑
Description:
This routine copies a single entry from one
KeyMap into another.
Invocation
CALL AST_MAPCOPYENTRY( THIS, KEY, THAT, MERGE, STATUS )
Arguments
THIS
= INTEGER (Given)
Pointer to the destination KeyMap.
KEY = CHARACTER
(
)
(Given)
The character string identifying the value to be copied. Trailing spaces are ignored. The
supplied string is converted to upper case before use if the
KeyCase attribute is currently set to zero.
THAT = INTEGER (Given)
Pointer to the source KeyMap.
MERGE = LOGICAL (Given)
Indicates what to do if the named entry holds a KeyMap and a KeyMap entry with the
same key already exists in the destination KeyMap. If .FALSE., the existing destination
KeyMap will be deleted and replaced by a copy of the source KeyMap. If .TRUE., all entries in
the source KeyMap will be copied into the existing destination KeyMap using routine
AST_MAPCOPY.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
-
This fuction returns without action if the named entry does not exist in the source KeyMap.
-
Entries from the source KeyMap will replace any existing entries in the destination KeyMap that have
the same key.
-
If the destination entry has a non-zero value for its MapLocked attribute, then an error will be
reported if the source KeyMap contains any keys that do not already exist within the destination
KeyMap.
Copyright (C) 2021 East Asian Observatory
- ←Prev
- AST
A Library for Handling
World Coordinate
Systems
in Astronomy - Next→
- TOC ↑