Next: Decode String into
Up: String Scanning and
Previous: Decode String into
This Subprogram will attempt to decode the specified text string into
a Floating Point (Real) Value.
Short Name Calling Sequence
STATUS = UIDCRE(STRING,VALUE)
Long Name Calling Sequence
STATUS = UI_DECODE_REAL(...)
Input Arguments
STRING (Character) Text String
VALUE (Real) Default Value
Output Arguments
VALUE (Real) Decoded Value
Function Value
UI__SUCCESS ) Success
UISUCC )
UI__DEFAULTED ) Defaulted
UIDFLT )
UI__ILLEGAL_SYNTAX ) Illegal Syntax
UIILSY )
Note:
- The UI__ILLEGAL_SYNTAX Function Value will be returned if the
text string does not conform to the correct Floating Point (Real) Number
syntax (see Notes for UI_GET_REAL). No modification will be made to the
default value in this case.
- The UI__DEFAULTED Function Value indicates that the specified String
is null (all spaces).
- All Errors are informational only, no Error Message will be issued.
- Any leading or trailing spaces or tabs within STRING will be ignored.
- See UI_GET_REAL for further notes on Arguments.
Liz Buckle
Fri Jan 13 17:28:23 CST 1995