Simulate Input by a Text String

This Subprogram inserts a Text String into the Input Buffer as if it had been typed. Until this string is exhausted, all further requests for Input will be satisfied by scanning words from within the string.

Short Name Calling Sequence

STATUS = UISIIN(STRING)

Long Name Calling Sequence

STATUS = UI_SIMULATE_INPUT(...)

Input Arguments

STRING (Character) Text String

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

Note:

1. The Text String may be up to 256 characters long and is case-insensitive.
2. The Text String is inserted before any text that still remains in the Input Buffer. The Buffer should be explicitly flushed (UI_FLUSH_INPUT) if so desired.