.\"##
.\" $XConsortium: p032,v 5.2 94/04/17 20:54:34 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 ELEMENTS BETWEEN LABELS" 3P "29 February 1991"
.SH NAME
DELETE ELEMENTS BETWEEN LABELS \- delete all elements in the open structure between specified labels
.IX "Editing" "DELETE ELEMENTS BETWEEN LABELS"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pdel_elems_labels ( label1_id, label2_id )
Pint	label1_id;	\fIlabel 1 identifier\fP
Pint	label2_id;	\fIlabel 2 identifier\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
Use \s-2DELETE ELEMENTS BETWEEN LABELS\s+2 to delete structure elements in the open structure between two specified labels. The elements containing the labels are not deleted.
.SS C Input Parameters
.IP \fIlabel1_id \fP
The subroutine begins deleting structures with the structure element immediately following this label.
.IP \fIlabel2_id \fP
The subroutine ends deleting structures with the structure element immediately preceding this label.
.SS Execution
The \s-2DELETE ELEMENTS BETWEEN LABELS\s+2 subroutine removes all the elements in the open structure between the two specified labels. The remaining elements are renumbered and the element pointer is updated to point to label 1 identifier.
.sp
The subroutine searches for the specified labels only from the current position of the element pointer in the structure to the end of the structure. The next occurrence of an element containing label 1 identifier is first found; then, starting from the element containing label 1 identifier, the next occurrence of an element containing label 2 identifier is found.
.sp
If either of the label identifiers cannot be found between the current position of the element pointer and the end of the structure, no elements are deleted and an error is generated.
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)
.IP 206
Ignoring function, one or both of the labels does not exist
in the open structure between the element pointer and the end of the structure
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "DELETE ELEMENT (3P)"
.SM "DELETE ELEMENT RANGE (3P)"
.SM "EMPTY STRUCTURE (3P)"
.fi
