next up previous
Next: DAT_CLONE - Clone locator
Up: ROUTINE DESCRIPTIONS
Previous: DAT_CELL - Locate cell

DAT_CLEN - Obtain character string length   

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