DELETE ELEMENTS BETWEEN LABELS

PDEL_ELEMS_LABELS

CALL SEQUENCE

void pdel_elems_labels(

Pint	label1_id	/* label 1 identifier	*/
Pint	label2_id	/* label 2 identifier	*/

)

PHIGS STATE

EFFECT

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

The function searches the first occurrence of label1_id, from the element following the element pointer. When this is found, it searches for the first occurrence of label2_id. The new position of element pointer is at label2_id'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