.\" @(#)PEXDeleteBetweenLabels.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXDeleteBetweenLabels 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXDeleteBetweenLabels \- Delete Elements Between Labels
.SH SYNTAX
.HP
void PEXDeleteBetweenLabels\^(\^Display *\fIdisplay\fP\^, PEXStructure \fIstructure\fP\^, long \fIlabel1\fP\^, long \fIlabel2\fP\^)
.SH PARAMETERS
.TP 1i
.I display
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
.I structure
The resource identifier of the structure.
.TP
.I label1
The first label.
.TP
.I label2
The second label.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXDeleteBetweenLabels
.LP
This function deletes a range of elements from the specified
.I structure.
Elements between the two labels are deleted.
The label elements are not deleted.  A search for the first
label is performed starting at the current offset plus one.
A search for the second label is performed starting at the element following
the first label.  After the deletion operation, the
.I structure
element
pointer is set to the pointer position at the first label.
.LP
If either of the two labels is not found between the starting point of the
search and the end of the
.I structure,
no deletion occurs and the structure's
element point is left unchanged.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
.fi
.sp
.SH ERRORS
.TP
.SB BadPEXLabel
The specified label does not exist.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateStructure (3)
.BR PEXLabel (3)
.fi