- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑
Description:
The routine copies an array to a new
location and returns an identifier for the resulting new base array.
Invocation
CALL ARY_COPY(
IARY1, PLACE, IARY2, STATUS )
Arguments
IARY1 = INTEGER (Given)
Identifier for the array
(or array section) to be copied.
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 array.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
-
The result of copying a scaled or delta array will be an 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 ↑