NAME

DELETE ELEMENT RANGE − delete a block of elements in a structure

SYNOPSIS

C Syntax

void
pdel_elem_range ( ep1_value, ep2_value )
Pintep1_value;element pointer 1 value
Pintep2_value;element pointer 2 value

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

Use DELETE ELEMENT RANGE to delete all structure elements in the open structure between, and including, two specified element numbers. 

C Input Parameters

ep1_value
Specifies the beginning of the element range to be deleted.

ep2_value
Specifies the end of the element range to be deleted.

Execution

The DELETE ELEMENT RANGE subroutine removes structure elements from the open structure between and including the lower and the higher of the element positions specified by element pointer 1 value and element pointer 2 value. The remaining elements in the structure are renumbered and the element pointer is updated to point to the element preceding the deleted elements.  If an element position is less than 1, the range of elements to be deleted will start from element position 0. If an element position is greater than the number of elements in the open structure, the range of elements to be deleted will end at the last element of the open structure.

ERRORS

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

SEE ALSO

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

September 02, 1992