XSaveContext(3X11) XLIB FUNCTIONS XSaveContext(3X11)NAME
XSaveContext, XFindContext, XDeleteContext, XUniqueContext
- associative look-up routines
SYNTAX
int XSaveContext(display, rid, context, data)
Display *display;
XID rid;
XContext context;
XPointer data;
int XFindContext(display, rid, context, data_return)
Display *display;
XID rid;
XContext context;
XPointer *data_return;
int XDeleteContext(display, rid, context)
Display *display;
XID rid;
XContext context;
XContext XUniqueContext()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 speci-
fied 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
X Version 11 Release 6.4 1
XSaveContext(3X11) XLIB FUNCTIONS XSaveContext(3X11)
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
X Version 11 Release 6.4 2