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

SAMPLE STRING (PHOP,WSOP,*,*)

Purpose

Use Sample String to retrieve the current measure of the specified string device.

Language Bindings

C

psample_string (ws_id, string_num, string)

Input Parameters

Pint ws_id
Workstation identifier.

Pint string_num
String device number (>=1).

Output Parameters

char *string
Character string. The application must allocate the memory for the character string returned. The Initialize String subroutine or the Initialize String 3 subroutine specifies the maximum size of the returned character size. 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

PSMST (wkid, stdnr, lostr, str)

Input Parameters

integer wkid
Workstation identifier.

integer stdnr
String device number (>=1).

Output Parameters

integer lostr
Number of characters returned.

character*(*) str
Character string.

FORTRAN Subset

PSMST (wkid, stdnr, lostr, str)

Input Parameters

integer wkid
Workstation identifier.

integer stdnr
String device number (>=1).

Output Parameters

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
252
Function Requires Input Device To Be In Sample Mode

Related Subroutines

  • Inquire Number Of Available Logical Input Devices

  • Set String Mode

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