NAME

EMPTY STRUCTURE − remove all elements from structure

SYNOPSIS

C Syntax

void
pempty_struct ( struct_id )
Pintstruct_id;structure id

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use EMPTY STRUCTURE to remove all the structure elements from a specified structure. The structure continues to exist as an empty structure even if there are no references to it in other structures. Any references that do exist are not changed by the EMPTY STRUCTURE subroutine. 

C Input Parameter

struct_id
Specifies the structure from which all structure elements should be removed.

Execution

The EMPTY STRUCTURE subroutine removes all the structure elements from structure identifier.  The structure specified may be the open structure, another existing structure, or a non-existent structure.  If structure identifier is the currently open structure or an existing structure, EMPTY STRUCTURE removes all elements from the structure and sets the element pointer to 0. Any references to this structure in other structures are not changed.  If the structure specified by structure identifier does not exist, EMPTY STRUCTURE creates a new empty structure. 

ERRORS

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

SEE ALSO

DELETE ELEMENT RANGE (3P)
DELETE ELEMENTS BETWEEN LABELS (3P)
DELETE STRUCTURE (3P)

September 02, 1992