NAME
XSaveContext, XFindContext, XDeleteContext, XUniqueContext - associative look-up
routines
SYNTAX
int
XSaveContext(Display * display, XID rid, XContext
context, XPointer data);
int
XFindContext(Display * display, XID rid, XContext
context, XPointer * data_return);
int
XDeleteContext(Display * display, XID rid, XContext
context);
XContext XUniqueContext(void);
ARGUMENTS
- context
- Specifies the context type to which the data belongs.
- data
- Specifies the data to be associated with the window and
type.
- data_return
- Returns the data.
- display
- Specifies the connection to the X server.
- rid
- Specifies the resource ID with which the data is
associated.
DESCRIPTION
If an entry with the specified resource ID and type already exists,
XSaveContext overrides it with the specified context. The
XSaveContext function returns a nonzero error code if an error has
occurred and zero otherwise. Possible errors are
XCNOMEM (out of
memory).
Because it is a return value, the data is a pointer. The
XFindContext
function returns a nonzero error code if an error has occurred and zero
otherwise. Possible errors are
XCNOENT (context-not-found).
The
XDeleteContext function deletes the entry for the given resource ID
and type from the data structure. This function returns the same error codes
that
XFindContext returns if called with the same arguments.
XDeleteContext does not free the data whose address was saved.
The
XUniqueContext function creates a unique context type that may be
used in subsequent calls to
XSaveContext.
SEE ALSO
Xlib - C Language X Interface