XSaveContext(3X11) BSD XSaveContext(3X11)
NAME
XSaveContext, XFindContext, XDeleteContext, XUniqueContext - associative
look-up routines
SYNTAX
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 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 - C Language X Interface