.\"##
.\" $XConsortium: p031,v 5.2 94/04/17 20:54:33 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "DELETE ELEMENT RANGE" 3P "29 February 1991"
.SH NAME
DELETE ELEMENT RANGE \- delete a block of elements in a structure
.IX "Editing" "DELETE ELEMENT RANGE"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pdel_elem_range ( ep1_value, ep2_value )
Pint	ep1_value;	\fIelement pointer 1 value\fP
Pint	ep2_value;	\fIelement pointer 2 value\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
Use \s-2DELETE ELEMENT RANGE\s+2 to delete all structure elements in the open structure between, and including, two specified element numbers.
.SS C Input Parameters
.IP \fIep1_value \fP
Specifies the beginning of the element range to be deleted.
.IP \fIep2_value \fP
Specifies the end of the element range to be deleted.
.SS Execution
The \s-2DELETE ELEMENT RANGE\s+2 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.
.sp
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.
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "DELETE ELEMENT (3P)"
.SM "DELETE ELEMENTS BETWEEN LABELS (3P)"
.SM "EMPTY STRUCTURE (3P)"
.fi