GPEPLB - Set Element Pointer at Label

Purpose

Use GPEPLB to set the element pointer to the specified label element within the open structure.

Starting at the position following the element pointer, the graPHIGS API searches for the first occurrence of the specified label If the end of the structure is reached, the system continues the search at element 1. If the specified label is not found, an error is generated.

Note: This subroutine is not processed by the nucleus right away. It is processed by the nucleus when the next subroutine call is issued that forces requests to be sent to the nucleus. See "Controlling the System" section in the The graPHIGS Programming Interface: Understanding Concepts for a discussion on when requests are sent to the nucleus for processing.

Parameters