next up previous
Next: ARY_FORM - Obtain the storage form of an array
Up: Routine Descriptions
Previous: ARY_DUPE - Duplicate an array

ARY_FIND  -  Find an array in an HDS structure and import it into the ARY_ system

Description:
The routine finds a named array within an HDS structure, imports it into the ARY_ system and issues an identifier for it. The imported array may then be manipulated by the ARY_ routines.

Invocation:
CALL ARY_FIND( LOC, NAME, IARY, STATUS )

Arguments:
LOC = CHARACTER ( ) (Given)
Locator to the enclosing HDS structure.
NAME = CHARACTER ( ) (Given)
Name of the HDS structure component to be imported.
IARY = INTEGER (Returned)
Array identifier.
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 IARY argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason. The ARY__NOID constant is defined in the include file ARY_PAR.



next up previous
Next: ARY_FORM - Obtain the storage form of an array
Up: Routine Descriptions
Previous: ARY_DUPE - Duplicate 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