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

GPOEP - Offset Element Pointer

GPOEP (offset)

Purpose

Use GPOEP to move the element pointer to a new element relative to the current element pointer.

This subroutine adds the pointer offset value to the element pointer. The value can either be positive, which moves the element pointer forward, or negative, which moves the element pointer backward. If the resultant value is less than zero, then the element pointer defaults to a value of zero. If the resultant value is greater than the number of elements in the open structure, then the graPHIGS API sets the pointer to point to the last element.

Parameters

offset -- specified by user, fullword integer

Element pointer offset value:

Positive offset value

Moves element pointer forward.

Negative offset value

Moves element pointer backward.

Error Codes

4
FUNCTION REQUIRES STATE STOP

Related Subroutines

GPQEP
Inquire Element Pointer

RCP code

201332226 (X'0C001602')


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