next up previous
Next: ARY_FIND - Find an array in an HDS structure and import it into the ARY_ system
Up: Routine Descriptions
Previous: ARY_DIM - Enquire the dimension sizes of an array

ARY_DUPE  -  Duplicate an array

Description:
The routine duplicates an array, creating a new base array with the same attributes as an existing array (or array section). The new array is left in an undefined state.

Invocation:
CALL ARY_DUPE( IARY1, PLACE, IARY2, STATUS )

Arguments:
IARY1 = INTEGER (Given)
Identifier for the array to be duplicated.
PLACE = INTEGER (Given and Returned)
An array placeholder (e.g. generated by the ARY_PLACE routine) which indicates the position in the data system where the new array will reside. The placeholder is annulled by this routine, and a value of ARY__NOPL will be returned (as defined in the include file ARY_PAR).
IARY2 = INTEGER (Returned)
Identifier for the new duplicate array.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • If this routine is called with STATUS set, then a value of ARY__NOID will be returned for the IARY2 argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason. In either event, the placeholder will still be annulled. The ARY__NOID constant is defined in the include file ARY_PAR.



next up previous
Next: ARY_FIND - Find an array in an HDS structure and import it into the ARY_ system
Up: Routine Descriptions
Previous: ARY_DIM - Enquire the dimension sizes of an array



ARY A Subroutine Library for Accessing ARRAY Data Structures
Starlink User Note 11
R.F. Warren-Smith
28th April 1998
E-mail:rfws@star.rl.ac.uk