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

GPEPCD - Locate Element Pointer at Element Code

GPEPCD (code)

Purpose

Use GPEPCD to set the element pointer to the next occurrence of the structure element with the specified code (i.e., the structure element identifier) If no element with the specified element code is found between the current element pointer and the end of the open structure, then the graPHIGS API issues an error and the element pointer remains the same.

Valid element codes are found in the The graPHIGS Programming Interface: Technical Reference

Note:

Element codes used in Version 1 are not supported by this subroutine.

Parameters

code -- specified by user, fullword integer

Element code. For a list of element codes used by the graPHIGS API, see The graPHIGS Programming Interface: Technical Reference

Error Codes

4
FUNCTION REQUIRES STATE STOP
132
ELEMENT CODE DOES NOT EXIST BEFORE END OF STRUCTURE

Related Subroutines

GPQE
Inquire Element Content
GPQEHD
Inquire List of Element Headers

RCP code

201332229 (X'0C001605')


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