GPHIGS C FUNCTIONS - SAMPLE STRING

Functions Index

SAMPLE STRING

PSAMPLE_STRING

CALL SEQUENCE

void psample_string(

Pint 	ws_id,	/* workstation identifier	*/
Pint 	string_dev,	/* string device number	*/
char	*string	/* (out) 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

Functions Index