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

Decode String into Integer Bounds

This Subprogram attempt to decode the specified text string into an Integer Upper and Lower Bound.

Short Name Calling Sequence

STATUS = UIDCIB(STRING,VALUES)

Long Name Calling Sequence

STATUS = UI_DECODE_INT_BOUNDS(...)

Input Arguments

STRING (Character) Text String VALUES (Integer Array) Default Bounds

Output Arguments

VALUES (Integer Array) Decoded Bounds

Function Value

UI__SUCCESS ) Success UISUCC )

UI__DEFAULTED ) Defaulted UIDFLT )

UI__ILLEGAL_SYNTAX ) Illegal Syntax UIILSY ) Note:

  1. The UI__ILLEGAL_SYNTAX Function Value will be returned if the text string does not conform to the correct Integer Bounds syntax (see Notes for UI_GET_INT_BOUNDS). No modification will be made to the default value in this case.
  2. The UI__DEFAULTED Function Value indicates that the specified String is null (all spaces).
  3. All Errors are informational only, no Error Message will be issued.
  4. Any leading or trailing spaces or tabs within STRING will be ignored.
  5. See UI_GET_INT_BOUNDS for further notes on Arguments.


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