INQUIRE STRUCTURE STATUS(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE STRUCTURE STATUS − inquire the status of a specified structure

SYNOPSIS

C Syntax

void
pinqstructstatus ( struct_id, error_ind, status )
Pintstruct_id;structure identifier
Pint∗error_ind;OUT error indicator
Pstructstatus∗status;OUT existence status

FORTRAN Syntax

SUBROUTINE pqstst ( STRID, ERRIND, STRSTI )
INTEGERSTRIDstructure identifier
INTEGERERRINDOUT error indicator
INTEGERSTRSTIOUT structure status indicator

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE STRUCTURE STATUS to determine the existence status of the specified structure (NON_EXISTENT, EMPTY, or NOTEMPTY).

C Input Parameters

struct_id
Identifier of the structure for which the status is to be returned.

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 Pstructstatus enumerated variable in which the system returns the existence status of the specified structure. Values for Pstructstatus are defined in phigs.h as follows:

PSTAT_NON_EXISTENT
PSTAT_EMPTY
PSTAT_NON_EMPTY

FORTRAN Input Parameters

STRID
Identifier of the structure for which the status is to be returned.

FORTRAN Output Parameters

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

STRSTI
The existence status of the specified structure, defined in phigs77.h as follows:

PSNOEXNon-existent
PSEMPTEmpty
PSNEMPNot Empty

ERRORS

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

Museum