NAME

SET ELEMENT POINTER AT LABEL − set the element pointer to the next occurrence of the specified label

SYNOPSIS

C Syntax

void
pset_elem_ptr_label ( label_id )
Pintlabel_id;label identifier

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET ELEMENT POINTER AT LABEL sets the element pointer of the currently open structure to the next occurrence in the structure of an element containing the specified label identifier. Label structure elements are created by the LABEL subroutine. 

C Input Parameter

label_id
Specifies the label identifier in the open structure at which to set the element pointer.

Execution

SET ELEMENT POINTER AT LABEL searches for the label identifier from the structure element following the current element pointer to the end of the open structure. If an occurrence of label identifier is not found between the current element pointer and the end of the structure, the subroutine does not move the element pointer and generates an error. 

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

205Ignoring function, the label does not exist in the open structure between the element pointer and the end of the structure

SEE ALSO

OFFSET ELEMENT POINTER (3P)
INQUIRE ELEMENT POINTER (3P)
INQUIRE CURRENT ELEMENT TYPE AND SIZE (3P)
SET ELEMENT POINTER (3P)
SET ELEMENT POINTER AT PICK IDENTIFIER (3P+)
ELEMENT SEARCH (3P)
LABEL (3P)

September 02, 1992