Name

PEXSetElementPtrAtLabel - Set Structure Element Pointer at Label

Synopsis

void PEXSetElementPtrAtLabel(Display ∗display, PEXStructure structure, long label, long offset)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call. 

structureThe resource identifier of the structure. 

labelThe value of the label. 

offsetThe offset from the label. 

Returns

None

Description

This function sets the element pointer for the specified structure at a position denoted by the label.  A search is conducted for the next occurrence of the label, starting at the current element pointer position plus one and proceeding in the forward direction.  If label is found, the element pointer for the structure is set to the location of the label plus the value of the specified offset.  If label is not found, the structure’s element pointer is left unchanged. 

Data Structures

typedef XID             PEXStructure;

Errors

BadPEXLabel
The specified label does not exist.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

PEXCreateStructure, PEXLabel