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

GPMVER - Move Element Range

GPMVER (elem1, elem2)

Purpose

Use GPMVER to move a range of elements from an open structure back into the same open structure but inserted following the current element pointer. The element pointer moves to the last element moved into the open structure.

  • If the value for elem1 is greater than the value for elem2, then the values are swapped. (The element range always starts at the lowest value and ends at the highest value.)

  • If both values point beyond the last element of the specified structure or if both values are less than one, then the graPHIGS API does not perform the move.

  • If one of the values is less than one, then the element number defaults to a value of one.

  • If one of the values is greater than the number of elements in the specified structure, then the element number of the last element in that structure is used instead.

  • If the element range includes the element pointed to by the current element pointer, then the graPHIGS API does not perform the move.

    • The value of the edit mode set by GPEDMO does not affect the functionality of this subroutine.

    Parameters

    elem1 -- specified by user, fullword integer

    Element number of the first element to move.

    elem2 -- specified by user, fullword integer

    Element number of the last element to move.

    Error Codes

    4
    FUNCTION REQUIRES STATE STOP

    Related Subroutines

    None

    RCP code

    201338627 (X'0C002F03')

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