NAME

OFFSET ELEMENT POINTER − move the element pointer in the open structure relative to its current position

SYNOPSIS

C Syntax

void
poffset_elem_ptr ( ep_offset )
Pintep_offset;element pointer offset

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

OFFSET ELEMENT POINTER moves the element pointer in the currently open structure a specified number of elements from its current position. 

C Input Parameter

ep_offset
Specifies the number of structure elements to move the element pointer from its current position.

Execution

OFFSET ELEMENT POINTER adds element pointer offset to the value of the element pointer in the open structure. The offset may be positive or negative.  The pointer is set to point to the resulting element number.  If the resulting element number is less than 0, the element pointer is set to 0. If the resulting element number is greater than the number of elements in the open structure, the element pointer is set to the last element in the structure.

ERRORS

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

SEE ALSO

INQUIRE ELEMENT POINTER (3P)
INQUIRE CURRENT ELEMENT TYPE AND SIZE (3P)
ELEMENT SEARCH (3P)
SET ELEMENT POINTER (3P)
SET ELEMENT POINTER AT LABEL (3P)

September 02, 1992