DELETE STRUCTURE NETWORK(3P) — SUNPHIGS LIBRARY

NAME

DELETE STRUCTURE NETWORK − delete network of structures from central structure store

SYNOPSIS

C Syntax

void
pdelstructnet ( struct_id, ref_flag )
Pintstruct_id;structure identifier
Preffref_flag;reference handling flag

FORTRAN Syntax

SUBROUTINE pdsn ( STRID, REFHNF )
INTEGERSTRIDstructure identifier
INTEGERREFHNFreference handling mode (PDELE, PKEEP)

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use DELETE STRUCTURE NETWORK to remove from the Central Structure Store a specified structure and all structures referenced directly or indirectly by that structure.

A structure is referenced from within another structure by an EXECUTE STRUCTURE element created by the EXECUTE STRUCTURE subroutine. A structure network is a hierarchical arrangement of structures in which the original structure references subordinate structures which, in turn, reference other structures, and so on.

More than one EXECUTE STRUCTURE element can refer to the same structure, so that a structure referenced in the network to be deleted can also be referenced by structures in other networks. DELETE STRUCTURE NETWORK includes a reference handling flag parameter which controls whether to delete or keep these structures.

C Input Parameters

struct_id
Specifies the structure which is the beginning of the structure network to be deleted.

ref_flag
Controls how structures in the selected network that are also referenced by other structures outside the network are to be handled. Values for this parameter are defined in phigs.h as follows:

PDELETE
PKEEP

The use of these values is described in the Execution section below.

FORTRAN Input Parameters

STRID
Specifies the structure which is the beginning of the structure network to be deleted.

REFHNF
Controls how structures in the selected network that are also referenced by other structures outside the network are to be handled. Values for this parameter are defined in phigs77.h as follows:

PDELEDelete
PKEEPKeep

The use of these values is described in the Execution section below.

Execution

The DELETE STRUCTURE NETWORK subroutine deletes the structure specified by structure identifier and the structure network beginning with the specified structure. The structure network is the chain of structures referenced by EXECUTE STRUCTURE elements in structure identifier or in descendent structures. If structure identifier does not exist, the subroutine takes no action and does not return an error. The reference handling flag parameter controls how structures that are referenced both by this structure network and by another structure outside the network are handled.

•If reference handling flag is DELETE, DELETE STRUCTURE NETWORK removes all structures referenced in the structure network beginning with structure identifier even if those structures are also referenced by another structure outside this network.

•If reference handling flag is KEEP, DELETE STRUCTURE NETWORK will not remove structures referenced in this network which are also referenced by another structure outside this network. However, the structure specified by structure identifier is always deleted.

All structures that are actually deleted are deleted as if DELETE STRUCTURE were called for each individual structure; that is, the structure identifier, its contents, and all references to it are removed.

ERRORS

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

Museum