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

SET ELEMENT POINTER AT LABEL (PHOP,*,STOP,*)

Purpose

Use Set Element Pointer at Label to set the element pointer to the specified label identifier element within the open structure.

Starting at the position following the current element pointer, the graPHIGS API searches for the first occurrence of the specified label. If the element pointer is already positioned at an occurrence of the specified label, then the search starts at the next element. If the graPHIGS API does not find the label when the end of the structure is reached, then the graPHIGS API generates an error and does not change the position of the current element pointer.

Language Bindings

C

pset_elem_ptr_label (label_id)

Input Parameters

Pint label_id
Label identifier.

FORTRAN

PSEPLB (ep)

Input Parameters

integer label
Label identifier.

Errors

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

Related Subroutines

  • Inquire Element Pointer

  • Label

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