Name

pinq_struct_status − Returns a flag indicating whether the structure is empty, not empty, or non-existent. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

void pinq_struct_status (
  Pint              stid,        /∗ (I) Structure identifier ∗/
  Pint             ∗error_ind,   /∗ (O) Error indicator ∗/
  Pstruct_status   ∗status       /∗ (O) Structure status indicator ∗/
)

Data Structures

typedef enum {
    PSTRUCT_STATUS_NON_EXISTENT,    /∗ Structure does not exist. ∗/
    PSTRUCT_STATUS_EMPTY,           /∗ Structure is empty. ∗/
    PSTRUCT_STATUS_NOT_EMPTY        /∗ Structure is not empty. ∗/
} Pstruct_status;

Description

pinq_struct_status returns a structure status indicator of PSTRUCT_STATUS_NOT_EMPTY, except as follows:

•If the specified structure does not exist, the function returns a structure status indicator of PSTRUCT_STATUS_NON_EXISTENT. 

•If the specified structure exists (that is, if the structure identifier is known to the system) but contains no elements, the function returns a structure status indicator of PSTRUCT_STATUS_EMPTY. 

See Also

pdel_struct
pempty_struct
pinq_struct_ids
pinq_struct_status