Previous Next Up Title Contents General Index Functions Index Bookshelf

SAMPLE STRING

psample_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


Previous Next Up Title Contents General Index Functions Index Bookshelf