- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑
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:
-
Duplicating a scaled or delta array produces and equivalent simple array.
-
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.
- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑