[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

DELETE ELEMENTS BETWEEN LABELS (PHOP,*,STOP,*)

Purpose

Use Delete Elements Between Labels to delete all elements from the open structure between, but not including, the two specified labels. After deletion, the element pointer moves to the element specified by the label 1 identifier.

Starting from the current position of the element pointer, the graPHIGS API searches for label identifier 1. If the current position of the element pointer points to an occurrence of the label identifier 1, then the search starts at the next element. The search for label identifier 2 starts at the element following the label identifier 1 element. If neither label is found when the end of the structure is reached, then the graPHIGS API generates an error, does not perform the deletion, and does not change the current element pointer.

Language Bindings

C

pdel_elems_labels (label1_id, label2_id)

Input Parameters

Pint label1_id
Label 1 identifier.

Pint label2_id
Label 2 identifier.

FORTRAN

PDELLB (label1, label2)

Input Parameters

integer label1
Label 1 identifier.

integer label2
Label 2 identifier.

Errors

5
Function Requires State (PHOP,*,STOP,*)
206
Label(s) Not Between Element Pointer And End Of Structure

Related Subroutines

  • Label


  • [ Previous | Next | Contents | Glossary | Home | Search ]