Next: HDS_OPEN - Open container file
Up: ROUTINE DESCRIPTIONS
Previous: HDS_LOCK - Lock container file
- Description:
Create a new container file and return a primary locator to the
top-level object.
- Invocation:
CALL HDS_NEW( FILE, NAME, TYPE, NDIM, DIM, LOC, STATUS )
- Arguments:
-
FILE = CHARACTER * ( * ) (Given)
-
Container file name.
-
NAME = CHARACTER * ( DAT__SZNAM ) (Given)
-
Object name.
-
TYPE = CHARACTER * ( DAT__SZTYP ) (Given)
-
Data type.
-
NDIM = INTEGER (Given)
-
Number of dimensions.
-
DIM = INTEGER( NDIM ) (Given)
-
Object dimensions (ignored if NDIM is zero).
-
LOC = CHARACTER * ( DAT__SZLOC ) (Returned)
-
Object locator.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
If a file extension is not specified, `.sdf' is used. If type
matches one of the HDS primitive type names a primitive of that
type is created, otherwise the object is assumed to be a
structure. If the top-level object is a structure array, loc
will be associated with the complete array, not the first cell.
Thus, new components can only be created through another locator
which is explicitly associated with an individual cell (see
DAT_CELL).
Next: HDS_OPEN - Open container file
Up: ROUTINE DESCRIPTIONS
Previous: HDS_LOCK - Lock container file
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