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

INQUIRE STRUCTURE STATUS (PHOP,*,*,*)

Purpose

Use Inquire Structure Status to inquire whether or not the specified structure exists in the centralized structure store. If the specified structure does not exist, then the graPHIGS API sets the structure status indicator to NON-EXISTENT. If the structure exists and contains no elements, then the graPHIGS API sets the structure status indicator to EMPTY; otherwise, the graPHIGS API sets the structure status indicator to NOT EMPTY.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the structure status value in the output parameter. If the information is unavailable, then the value returned in the output parameter is unpredictable and the graPHIGS API sets the error indicator to the following error:

2
Function Requires State (PHOP,*,*,*)

Language Bindings

C

pinq_struct_status (struct_id, err_ind, status)

Input Parameters

Pint struct_id
Structure identifier.

Output Parameters

Pint *err_ind
Error indicator.

Pstruct_status *status
Structure status identifier (0=PSTRUCT_STATUS_NON_EXISTENT, 1=PSTRUCT_STATUS_EMPTY, 2=PSTRUCT_STATUS_NOT_EMPTY).

FORTRAN

PQSTST (strid, errind, strsti)

Input Parameters

integer strid
Structure identifier.

Output Parameters

integer errind
Error indicator.

integer strsti
Structure status identifier (0=PSNOEX, 1=PSEMPT, 2=PSNEMP).

Errors

None

Related Subroutines

  • None

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