Next: DAT_GET - Read primitive
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ERMSG - Translate a status value into an error message
- Description:
Obtain a locator for a named component.
- Invocation:
CALL DAT_FIND( LOC1, NAME, LOC2, STATUS )
- Arguments:
-
LOC1 = CHARACTER * ( DAT__SZLOC ) (Given)
-
Structure locator.
-
NAME = CHARACTER * ( DAT__SZNAM ) (Given)
-
Component name.
-
LOC2 = CHARACTER * ( DAT__SZLOC ) (Returned)
-
Component locator.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
If the structure is an array, loc1 must be explicitly associated
with an individual cell. If the component is a structure array,
loc2 will be associated with the complete array, not the first
cell. Access to its components can only be made through another
locator explicitly associated with an individual cell (see
DAT_CELL).
Next: DAT_GET - Read primitive
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ERMSG - Translate a status value into an error message
HDS Hierarchical Data System
Starlink User Note 92
R.F. Warren-Smith & M.D. Lawden
23rd February 1999
E-mail:rfws@star.rl.ac.uk
Copyright (C) 1999 Central Laboratory of the Research Councils