
Next:
ARY_DELET
-
Delete an array
Up: Routine Descriptions
Previous:
ARY_CMPLX
-
Determine whether an array holds complex values
ARY_COPY
-
Copy an array to a new location
- 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:
-
-
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:
ARY_DELET
-
Delete an array
Up: Routine Descriptions
Previous:
ARY_CMPLX
-
Determine whether an array holds complex values
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