REQUEST STRING
CALL SEQUENCE
PRQST (WKID, STDNR, STAT, LOSTR, STR)
INPUT PARAMETERS
INTEGER WKID
INTEGER STDNR
OUTPUT PARAMETERS
INTEGER STAT
INTEGER LOSTR
CHARACTER*(*) STR
ARGUMENTS
- WKID
- Workstation identifier.
- STDNR
- STRING input device identifier.
- STAT
- State of request carried out.
- PNONE:
- 0 (NONE)
- POK:
- 1 (OK)
- LOSTR
- Length of string.
- STR
- Selected character string.
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Request a character string from the keyboard with the possibility of cancelling
the input by activating the break key ( carriage return ).
Example:
C Request string on workstation number 1 using device number 1
INTEGER WKID,STDNR,STATUS,LOSTR
CHARACTER*80 STR
WKID = 1
STDNR = 1
call PRQST(WKID,STDNR,STATUS,LOSTR,STR)
......
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 61
- Ignoring function, specified workstation is neither of category INPUT nor
of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 251
- Ignoring function, the function requires the input device to be in REQUEST
mode
SEE ALSO
set string mode, initialize string, sample string, get string, await event,
inquire string device state, inquire default string device state 3