Decode String into Logical True False Set

This Subprogram will attempt to decode the specified text string into a Set of Logical (True/False) Values.

Short Name Calling Sequence

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

Long Name Calling Sequence

STATUS = UI_DECODE_LOG_SET(...) STATUS = UI_DECODE_LOGICAL_SET(...)

Input Arguments

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

Output Arguments

VALUES (Logical 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. The UI__ILLEGAL_SYNTAX Function Value will be returned if the text string does not conform to the correct Logical Set syntax. Individual set members may be 'TRUE' or 'FALSE' (or truncation thereof).
2. Unlike the other Decoding Subprograms UI_DECODE_LOG_SET 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.
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.