Decode String into Decimal Integer List of Values

This Subprogram will attempt to decode the specified text string into a List of Decimal Integer Values. No alternative syntaxes are allowed and thus Octal and Hexadecimal representations are not valid, unlike the case of UI_DECODE_INT_LIST.

Short Name Calling Sequence

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

Long Name Calling Sequence

STATUS = UI_DECODE_DEC_LIST(...)

Input Arguments

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

Output Arguments

VALUES (Integer Array) Decoded Values Array NVALUE (Integer) Decoded No. of Values

Function Value

UI__SUCCESS ) Success UISUCC )

UI__TRUNCATED ) Truncated UITRUN )

UI__ILLEGAL_SYNTAX ) Illegal Syntax UIILSY ) Note:

1. This Subprogram differs from UI_DECODE_DEC_SET in allowing for bounds specifications within the List. UI_DECODE_DEC_SET only allows for a sequence of enumerated decimal numbers, whereas this Subprogram allows implied sequences denoted by lower and upper bounds.
2. The UI__ILLEGAL_SYNTAX Function Value will be returned if the text string does not conform to the correct Decimal Integer List syntax (see Notes for UI_GET_DEC_LIST). No modification will be made to the default value in this case.
3. Unlike the other Decoding Subprograms UI_DECODE_DEC_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_DEC_LIST for further notes on Arguments.