.\" @(#)PEXSetElementPtr.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetElementPtr 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetElementPtr - Set Structure Element Pointer
.SH SYNTAX
.HP
void PEXSetElementPtr\^(\^Display *\fIdisplay\fP\^, PEXStructure \fIstructure\fP\^, int \fIwhence\fP\^, long \fIoffset\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIstructure\fP 1i
The resource identifier of the structure.
.IP \fIwhence\fP 1i
A value specifying with
.I offset,
the element pointer position (
.B PEXBeginning,
.B PEXCurrent,
.B PEXEnd
).
.IP \fIoffset\fP 1i
The offset from
.I whence
which specifies the element pointer position.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetElementPtr
.IX "Structure Elements" PEXSetElementPtr
.LP
This function sets the element pointer for the structure specified
to the position specified.
.LP
If either computed
.I offset
is less than zero, it is set to
zero before obtaining the element information.  If either
computed
.I offset
is greater than the number of elements in the
structure, it is set to the
.I offset
of the last structure
element in the structure.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
.fi
.sp .5
.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