.\" @(#)PEXSetElementPtrAtLabel.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetElementPtrAtLabel 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetElementPtrAtLabel - Set Structure Element Pointer at Label
.SH SYNTAX
.HP
void PEXSetElementPtrAtLabel\^(\^Display *\fIdisplay\fP\^, PEXStructure \fIstructure\fP\^, long \fIlabel\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 \fIlabel\fP 1i
The value of the label.
.IP \fIoffset\fP 1i
The offset from the label.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetElementPtrAtLabel
.IX "Structure Elements" PEXSetElementPtrAtLabel
.LP
This function sets the element pointer for the specified
.I structure
at a position denoted by the
.I label.
A search is conducted for
the next occurrence of the
.I label,
starting at the current element pointer position plus
one and proceeding in the forward direction.  If
.I label
is found, the element pointer for the
.I structure
is set to the
location of the
.I label
plus the value of the specified
.I offset.
If
.I label
is not found, the structure's element
pointer is left unchanged.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
.fi
.sp .5
.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