NAME

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

SYNOPSIS

C Syntax

void
poffsetelemptr ( ep_offset )
Pintep_offset;element pointer offset

FORTRAN Syntax

SUBROUTINE posep ( EPO )
INTEGEREPOelement 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.

FORTRAN Input Parameter

EPOSpecifies 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)

Sun Release 4.0  —  Last change: 5 July 1989