XSaveContext(3X11) X11 SDE 5.4R3.00 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, datareturn)
Display *display;
XID rid;
XContext context;
XPointer *datareturn;
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.
datareturn
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
Licensed material--property of copyright holder(s) 1
XSaveContext(3X11) X11 SDE 5.4R3.00 XSaveContext(3X11)
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
Licensed material--property of copyright holder(s) 2