DELETE ELEMENT RANGE(3P) — SUNPHIGS LIBRARY

NAME

DELETE ELEMENT RANGE − delete a block of elements in a structure

SYNOPSIS

C Syntax

void
pdelelemrange ( ep1_value, ep2_value )
Pintep1_value;element pointer 1 value
Pintep2_value;element pointer 2 value

FORTRAN Syntax

SUBROUTINE pdelra ( EP1, EP2 )
INTEGEREP1, EP2element pointer range

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

Use DELETE ELEMENT RANGE to delete all structure elements in the open structure between, and including, two specified element numbers.

C Input Parameters

ep1_value
Specifies the beginning of the element range to be deleted.

ep2_value
Specifies the end of the element range to be deleted.

FORTRAN Input Parameters

EP1
Specifies the beginning of the element range to be deleted.

EP2
Specifies the end of the element range to be deleted.

Execution

The DELETE ELEMENT RANGE subroutine removes structure elements from the open structure between and including the lower and the higher of the element positions specified by element pointer 1 value and element pointer 2 value. The remaining elements in the structure are renumbered and the element pointer is updated to point to the element preceding the deleted elements. If an element position is less than 1, the range of elements to be deleted will start from element position 0. If an element position is greater than the number of elements in the open structure, the range of elements to be deleted will end at the last element of the open structure.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum