NAME

INQUIRE STRUCTURE STATUS − inquire the status of a specified structure

SYNOPSIS

C Syntax

void
pinq_struct_status ( struct_id, error_ind, status )
Pintstruct_id;structure identifier
Pint∗error_ind;OUT error indicator
Pstruct_status∗struct; OUT existence status

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.

structA pointer to a Pstruct_status enumerated variable in which the system returns the existence status of the specified structure.  Values for Pstruct_status are defined in phigs.h as follows:

PSTRUCT_STATUS_NON_EXISTENT
PSTRUCT_STATUS_EMPTY
PSTRUCT_STATUS_NOT_EMPTY

ERRORS

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

SEE ALSO

DELETE STRUCTURE (3P)
EMPTY STRUCTURE (3P)
INQUIRE STRUCTURE IDENTIFIERS (3P)

September 02, 1992