Move an object to a new location (ie. copy and erase the
CALL DAT_MOVE( LOC1, LOC2, NAME, STATUS )
LOC1 = CHARACTER
) (Given and Returned)
. A value of DAT__NOLOC is returned.
LOC2 = CHARACTER
DAT__SZLOC ) (Given)
NAME = CHARACTER
DAT__SZNAM ) (Given)
STATUS = INTEGER (Given and Returned)
If the object is an array, loc1 must point to the complete array, not a slice or cell.
loc1 is annulled
if the operation is successful (if it is the last primary
locator associated with a
container file, then the container file will be closed – see DAT_PRMRY
). The operation will fail if a
component of the same name already exists in the structure. The object to be moved need not be in the
same container file as the structure.
Copyright © 2019 East Asian Observatory