NAME

DELETE ELEMENTS BETWEEN LABELS − delete all elements in the open structure between specified labels

SYNOPSIS

C Syntax

void
pdel_elems_labels ( label1_id, label2_id )
Pintlabel1_id;label 1 identifier
Pintlabel2_id;label 2 identifier

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

Use DELETE ELEMENTS BETWEEN LABELS to delete structure elements in the open structure between two specified labels. The elements containing the labels are not deleted. 

C Input Parameters

label1_id
The subroutine begins deleting structures with the structure element immediately following this label.

label2_id
The subroutine ends deleting structures with the structure element immediately preceding this label.

Execution

The DELETE ELEMENTS BETWEEN LABELS subroutine removes all the elements in the open structure between the two specified labels. The remaining elements are renumbered and the element pointer is updated to point to label 1 identifier.  The subroutine searches for the specified labels only from the current position of the element pointer in the structure to the end of the structure. The next occurrence of an element containing label 1 identifier is first found; then, starting from the element containing label 1 identifier, the next occurrence of an element containing label 2 identifier is found. If either of the label identifiers cannot be found between the current position of the element pointer and the end of the structure, no elements are deleted and an error is generated.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

206Ignoring function, one or both of the labels does not exist in the open structure between the element pointer and the end of the structure

SEE ALSO

DELETE ELEMENT (3P)
DELETE ELEMENT RANGE (3P)
EMPTY STRUCTURE (3P)

September 02, 1992