NAME

DELETE ELEMENT − delete structure element

SYNOPSIS

C Syntax

void
pdel_elem ()

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

DELETE ELEMENT deletes the structure element currently pointed to by the element pointer in the open structure. 

C Input Parameters

None

Execution

The DELETE ELEMENT subroutine removes the structure element currently pointed to by the element pointer in the open structure and renumbers the remaining elements in the structure to maintain a consecutive, ascending order in the structure.  When the element is deleted, the element pointer is set to point to the element preceding the deleted element in the structure. If the element pointer is 0 (pointing to the position in the structure before any elements) when DELETE ELEMENT is called, the subroutine will not delete any element and will not adjust the element pointer. 

ERRORS

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

SEE ALSO

SET EDIT MODE (3P)
EMPTY STRUCTURE (3P)
DELETE ELEMENT RANGE (3P)
DELETE ELEMENTS BETWEEN LABELS (3P)

September 02, 1992