### AST_MAPCOPYENTRY

Copy a single entry from one KeyMap into another

#### 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 $\ast$ ( $\ast$ ) (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.