.\" @(#)PEXDeleteElements.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXDeleteElements 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXDeleteElements \- Delete Elements
.SH SYNTAX
.HP
void PEXDeleteElements\^(\^Display *\fIdisplay\fP\^, PEXStructure \fIstructure\fP\^, int \fIwhence1\fP\^, long \fIoffset1\fP\^, int \fIwhence2\fP\^, long \fIoffset2\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIstructure\fP
The resource identifier of the structure.
.TP
\fIwhence1\fP
A value specifying, with \fIoffset1\fP, the first limit of the range of
elements to be deleted (
.B PEXBeginning,
.B PEXCurrent,
.B PEXEnd
).
.TP
\fIoffset1\fP
The offset from \fIwhence1\fP denoting the first limit of the range of
elements to be deleted.
.TP
\fIwhence2\fP
A value specifying, with \fIoffset2\fP, the second limit of the range of
elements to be deleted (
.B PEXBeginning,
.B PEXCurrent,
.B PEXEnd
).
.TP
\fIoffset2\fP
The offset from \fIwhence2\fP denoting the second limit of the range of
elements to be deleted.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXDeleteElements
.IX "Structure Elements" PEXDeleteElements
.LP
This function deletes a range of elements from the structure specified by
.I structure.
.LP
If a computed offset is less than zero, it is set to
zero before obtaining the element information.  If a
computed offset is greater than the number of elements in the
.I structure,
the offset is set to the offset of the last structure element in the
.I structure.
Deleting the null element is effectively
a no-op.  After the deletion operation, the structure element
pointer is set to the element immediately preceding the range
of deleted elements.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
.fi
.sp
.SH ERRORS
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.TP
.SB BadValue
The specified value for whence parameter is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateStructure (3)
.fi