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

GPEPLG - Generalized Set Element Pointer at Label

GPEPLG (label, flag)

Purpose

Use GPEPLG to set the element pointer to the specified pick identifier element within the open structure.

Starting at the position following the current element pointer, the graPHIGS API searches for the first occurrence of the specified label. If the end of the structure is reached, then the result depends on the value of the label search flag (flag) parameter:

  • If the value of the flag is 2=WRAP , then the search continues starting at element 1 until the current element pointer is encountered. If the specified label is not found, the graPHIGS API issues an error and no action is performed.

  • If the value of the flag is 1=NOWRAP , then the graPHIGS API issues an error and no action is performed.

    • Parameters

    label -- specified by user, fullword integer

    Label identifier.

    flag -- specified by user, fullword integer

    Label search flag (1=NOWRAP, 2=WRAP )

    Error Codes

    4
    FUNCTION REQUIRES STATE STOP
    130
    LABEL IDENTIFIER CANNOT BE FOUND IN THE OPEN STRUCTURE
    136
    VALUE OF SEARCH FLAG IS INVALID

    Related Subroutines

    GPINLB
    Insert Label

    RCP code

    201332230 (X'0C001606')

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