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

REQUEST STRING (PHOP,WSOP,*,*)

Purpose

Use Request String to have the graPHIGS API execute a request to the specified string device.

A status of NONE means that a break action occurred. Otherwise, the graPHIGS API returns a status of OK together with a character string which is set according to the current measure of the string device.

Language Bindings

C

preq_string (ws_id, string_num, in_status, string)

Input Parameters

Pint ws_id
Workstation identifier.

Pint string_num
String device number (>=1).

Output Parameters

Pin_status *in_status
Input status (0=PIN_STATUS_NONE, 1=PIN_STATUS_OK).

char *string
Requested string. The application must allocate the memory for the character string returned. The Initialize String subroutine The Initialize String subroutine or the Initialize String 3 subroutine specifies the maximum size of the returned character string. The Inquire Default String Device Data subroutine or the Inquire Default String Device Data 3 subroutine returns the maximum size of a character string supported by the workstation.

FORTRAN

PRQST (wkid, stdnr, stat, lostr, str)

Input Parameters

integer wkid
Workstation identifier.

integer stdnr
String device number (>=1).

Output Parameters

integer stat
Input status (0=PNONE, 1=POK).

integer lostr
Number of characters returned.

character*(*) str
Character string.

FORTRAN Subset

PRQST (wkid, stdnr, stat, lostr, str)

Input Parameters

integer wkid
Workstation identifier.

integer stdnr
String device number (>=1).

Output Parameters

integer stat
Input status (0=PNONE, 1=POK).

integer lostr
Number of characters returned.

character*80 str
Character string.

Errors

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
61
Specified Workstation Is Not Of Category Input Or Outin
250
Specified Device Not Available On Workstation
251
Function Requires Input Device To Be In Request Mode

Related Subroutines

  • Initialize String

  • Inquire Number Of Available Logical Input Devices

  • Set String Mode

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