GET STRING

PGTST

CALL SEQUENCE

CALL PGTST (LOSTR, STR)

OUTPUT PARAMETERS

INTEGER LOSTR

Length of string returned.

CHARACTER* (*) STR

Character string.

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Reads a STRING event. The logical input value is read in the current event report in the PHIGS state list. It contains a character string.

Example:

C Event string 
	INTEGER LOSTR
	CHARACTER*80 STRING

	.....
	call PGTST(LOSTR,STRING)
	......

ERRORS

3

Ignoring function, function requires state (PHOP, WSOP,*,*)

259

Ignoring function, the input device class of the current input report does not match the class

SEE ALSO

set string mode, initialize string , request string , sample string , await event, flush device events, inquire string device state, inquire default string device state