Name

PRQST − Prompts for input using the string-class logical input device specified. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
 

Syntax

PRQST (WKID, STDNR, STAT, LOSTR, STR)

Argument        Data Type       Access   Description
---------------------------------------------------------------------------
WKID            Integer         Read     Workstation identifier
STDNR           Integer         Read     String device number
STAT            Integer         Write    Status
LOSTR           Integer         Write    Number of characters returned
STR             Character ∗80   Write    Character string
---------------------------------------------------------------------------

Constants

Defined Argument     Constant       Description
---------------------------------------------------------------------------
STAT                 PNONE          User performed a break action.
                     POK            User entered a string.
---------------------------------------------------------------------------

Description

PRQST prompts for input using the string-class logical input device specified by the device number and the workstation identifier.  If the input status is POK, this function returns the character string. 

If you generate a string that contains more characters (including the initial string) than the number of components in the string buffer, you lose the additional input.  To establish a string buffer size, call the PINST function. 

See Also

PGTST
PINST
PQSTS
PSMST
PSSTM