Test whether Parameters remain on Input Line

This Subprogram tests whether more Parameters remain on the Input Line. It is intended for use in the situation where a Verb may have a variable number of Parameters associated with it. An example of this might be a PRINT command where at least one file must be specified, but more files may be printed if so desired.

Short Name Calling Sequence

STATUS = UIPARE(DUMMY)

Long Name Calling Sequence

STATUS = UI_PARAMETERS_REMAIN(...)

Input Arguments

DUMMY (Integer*4) Dummy Function Argument

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__EMPTY ) Line empty UIMPTY )

UI__NOT_INITIALIZED ) Package not Initialized UININI ) Note:

1. The UI__EMPTY Function value indicates that there are no more Parameters on the current Input Line. It is informational only, no signalling is performed.
2. The use of a variable number of Parameters with a particular Verb prohibits the typing of multiple responses on a single Input Line. If this is attempted in this situation, then the additional responses (presumably Verbs and their Parameters) will be treated as additional Parameters to the present Verb.