Decode String into Hexadecimal Bounds

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

Short Name Calling Sequence

STATUS = UIDCHB(STRING,VALUES)

Long Name Calling Sequence

STATUS = UI_DECODE_HEX_BOUNDS(...)

Input Arguments

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

Output Arguments

VALUE (Integer Array) Decoded Bounds Array

Function Value

UI__SUCCESS ) Success UISUCC )

UI__DEFAULTED ) Default 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 Hexadecimal Bounds syntax (see Notes for UI_GET_HEX_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. A valid bound specification will ensure that VALUES(1) (the lower bound) is always less than or equal to VALUES(2) (the upper bound).
5. Any leading or trailing spaces or tabs within STRING will be ignored.
6. See UI_GET_HEX_BOUNDS for further notes on Arguments.