XSaveContext(3X) XSaveContext(3X)
NAME
XSaveContext, XFindContext, XDeleteContext,
XUniqueContext - associative look-up routines
SYNOPSIS
int XSaveContext(display, w, context, data)
Display *display;
Window w;
XContext context;
caddr_t data;
int XFindContext(display, w, context, data_return)
Display *display;
Window w;
XContext context;
caddr_t *data_return;
int XDeleteContext(display, w, context)
Display *display;
Window w;
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 a pointer to the data.
display Specifies the connection to the X server.
w Specifies the window with which the data is
associated.
DESCRIPTION
If an entry with the specified window 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
- 1 -
XSaveContext(3X) XSaveContext(3X)
given window 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 Programming Manual
- 2 -