REQUEST STRING
CALL SEQUENCE
void preq_string(
Pint ws_id, /* workstation identifier */
Pint string_dev, /* string device number */
Pin_status *status, /* (out) input status */
char *string /* (out) string */
)
TYPES
typedef enum {
PIN_STATUS_NONE,
PIN_STATUS_OK,
PIN_STATUS_NO_IN
} Pin_status;
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