Next: DAT_CLONE - Clone locator
Up: ROUTINE DESCRIPTIONS
Previous: DAT_CELL - Locate cell
- Description:
The routine returns the number of characters required to
represent the values of a primitive object. If the object is
character-type, then its length is returned directly. Otherwise,
the value returned is the number of characters required to format
the object's values (as a decimal string if appropriate) without
loss of information.
- Invocation:
CALL DAT_CLEN( LOC, CLEN, STATUS )
- Arguments:
-
LOC = CHARACTER * ( DAT__SZLOC ) (Given)
-
Primitive object locator.
-
CLEN = INTEGER (Returned)
-
Character string length.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
-
The value returned by this routine is equal to the default
number of characters allocated to each element whenever a
primitive object is mapped using an access type of "_CHAR" (i.e.
without specifying the length to be used explicitly).
-
If this routine is called with STATUS set, then a value of 1
will be returned for the CLEN argument, although no further
processing will occur. The same value will also be returned if
the routine should fail for any reason.
Next: DAT_CLONE - Clone locator
Up: ROUTINE DESCRIPTIONS
Previous: DAT_CELL - Locate cell
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