Previous Next Up Title Contents Index Functions Index Top Library

DELETE ELEMENTS BETWEEN LABELS

PDELLB


CALL SEQUENCE

CALL PDELLB (LABEL1, LABEL2)

INPUT PARAMETERS

INTEGER LABEL1
First label.
INTEGER LABEL2
Second label.

PHIGS STATE

(PHOP, * STOP, *).

EFFECT

DELETE ELEMENTS BETWEEN LABELS destroys all the elements in the open structure between the two labels, excluding LABEL1 and LABEL2 . The elements following LABEL2 are renumbered and element pointer points to element LABEL1 .

The function searches the first occurrence of LABEL1 , from the element following the element pointer. When this is found, it searches for the first occurrence of LABEL2 . The new position of element pointer is at LABEL2's new position after renumbering.

If the function does not find one of the two labels, no element is destroyed and an error is generated.

ERRORS

5
Ignoring function, function requires state (PHOP,*, STOP,*)
206
Ignoring 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

open structure, set element pointer, empty structure, delete element range, delete element


Previous Next Up Title Contents Index Functions Index Top Library