Name

PEXDeleteBetweenLabels - Delete Elements Between Labels

Synopsis

void PEXDeleteBetweenLabels(Display ∗display, PEXStructure structure, long label1, long label2)

Arguments

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

structureThe resource identifier of the structure. 

label1The first label. 

label2The second label. 

Returns

None

Description

This function deletes a range of elements from the specified 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 structure element pointer is set to the pointer position at the first label. 

If either of the two labels is not found between the starting point of the search and the end of the structure, no deletion occurs and the structure’s element point 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