next up previous
Next: DAT_GET - Read primitive
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ERMSG - Translate a status value into an error message

DAT_FIND - Find named component   

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 up previous
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