INQUIRE OPEN STRUCTURE(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE OPEN STRUCTURE − inquire the status of the currently opened structure

SYNOPSIS

C Syntax

void
pinqopenstruct ( error_ind, status, struct_id )
Pint∗error_ind;OUT error indicator
Popenstructstatus∗status; OUT status of open structure
Pint∗struct_id;OUT structure identifier

FORTRAN Syntax

SUBROUTINE pqopst ( ERRIND, STYPE, STRID )
INTEGERERRINDOUT error indicator
INTEGERSTYPEOUT open structure status (PNONST, POPNST)
INTEGERSTRIDOUT structure identifier

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE OPEN STRUCTURE to determine the status of the currently open structure.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

statusA pointer to a Popenstructstatus enumerated type in which the system returns the status of the currently open structure. Values of Popenstructstatus are defined in phigs.h as follows:

PSTRUCT_NONENo Structure Is Open
PSTRUCT_OPENA Structure Is Open

struct_id
An integer pointer in which the system returns the structure identifier of the currently open structure. This value is undefined if status is PSTRUCT_NONE.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

STYPE
The status of the currently open structure, defined in phigs77.h as follows:

PNONSTNo Structure Is Open
POPNSTA Structure Is Open

STRID
The structure identifier of the currently open structure. This value is undefined if no structure is open (STYPE = PNONST).

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

Museum