SAMPLE STRING
CALL SEQUENCE
void psample_string (ws_id, string_dev, string)
INPUT PARAMETERS
Pint ws_id,
Pint string_dev,
OUTPUT PARAMETERS
char *string
ARGUMENTS
- ws_id,
- Workstation identifier
- string_dev,
- String device number
- string
- String
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Reads the current character string on the input device, string_dev.
Example:
/* Sample string on workstation number 1 using device number 1 */
Pint ws_id,string_dev;
char string[80];
.....
ws_id = 1;
string_dev = 1;
preq_string(ws_id,string_dev,string);
......
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
- 252
- Ignoring function, the function requires the input device to be in SAMPLE
mode
SEE ALSO
set string mode, initialize string 3, request string , get string , await
event, inquire string device state 3, inquire default string device state 3