XSaveContext(3X11) XLIB FUNCTIONS XSaveContext(3X11)
NAME
XSaveContext, XFindContext, XDeleteContext, XUniqueContext -
associative look-up routines
SYNTAX
int XSaveContext(Display *display, XID rid, XContext con-
text, XPointer data);
int XFindContext(Display *display, XID rid, XContext con-
text, XPointer *data_return);
int XDeleteContext(Display *display, XID rid, XContext con-
text);
XContext XUniqueContext(void);
ARGUMENTS
context Specifies the context type to which the data
belongs.
data Specifies the data to be associated with the win-
dow 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 con-
text. 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.
XFree86 Version 4.5.0 1
XSaveContext(3X11) XLIB FUNCTIONS XSaveContext(3X11)
SEE ALSO
Xlib - C Language X Interface
XFree86 Version 4.5.0 2