next up previous contents
Next: Decode String into Up: String Scanning and Previous: Decode String into

Decode String into Double Precision List of Values

This Subprogram will attempt to decode the specified text string into a List of Double Precision Values.

Short Name Calling Sequence

STATUS = UIDCPL(STRING,VALUES,VASIZE,NVALUE)

Long Name Calling Sequence

STATUS = UI_DECODE_DOUBLE_LIST(...)

Input Arguments

STRING (Character) Text String VASIZE (Integer) Maximum No. of Values

Output Arguments

VALUES (Real*8 Array) Decoded Values Array NVALUE (Integer) Decoded No. of returned Values

Function Value

UI__SUCCESS ) Success UISUCC )

UI__TRUNCATED ) List truncated UITRUN )

UI__ILLEGAL_SYNTAX ) Illegal Syntax UIILSY ) Note:

  1. The FORTRAN-77 name for this Subprogram does not conform to the normal UIPACK concentions in order to avoid a conflict with UIDCDL (UI_DECODE_DECIMAL_LIST).
  2. The UI__ILLEGAL_SYNTAX Function Value will be returned if the text string does not conform to the correct Double Precision syntax (see Notes for UI_GET_DOUBLE_LIST). No modification will be made to the default value in this case.
  3. Unlike the other Decoding Subprograms UI_DECODE_DOUBLE_LIST does not accept any Defaults. If the string is null (all spaces) then NVALUE will be set to zero, indicating that no Elements are present.
  4. All Errors are informational only, no Error Message will be issued.
  5. Any leading or trailing spaces or tabs within STRING will be ignored.
  6. See UI_GET_DOUBLE_LIST for further notes on Arguments.


Liz Buckle
Fri Jan 13 17:28:23 CST 1995