[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

GET STRING (PHOP,WSOP,*,*)

Purpose

Use Get String to retrieve a string input value from the current event report. The graPHIGS API does not remove the event from the current event report until the next invocation of the Await Event subroutine call.

The length of the returned string is less than, or equal to, the buffer size found in the string data record at the time the device was set to event mode.

The graPHIGS API identified the device to which this value corresponds on the previous invocation of Await Event.

Language Bindings

C

pget_string (string)

Output Parameters

char *string
String.

FORTRAN

PGTST (lostr, str)

Output Parameters

integer lostr
Number of characters returned.

character*(*) str
String.

FORTRAN Subset

PGTST (lostr, str)

Output Parameters

integer lostr
Number of characters returned.

character*80 str
String.

Errors

3
Function Requires State (PHOP,WSOP,*,*)
259
Requested Device Class Not Current Input Report Class

Related Subroutines

  • Await Event


  • [ Previous | Next | Contents | Glossary | Home | Search ]