1XSaveContext(3)                 XLIB FUNCTIONS                 XSaveContext(3)
2
3
4

NAME

6       XSaveContext, XFindContext, XDeleteContext, XUniqueContext - associa‐
7       tive look-up routines
8

SYNTAX

10       int XSaveContext(Display *display, XID rid, XContext context, XPointer
11              data);
12
13       int XFindContext(Display *display, XID rid, XContext context, XPointer
14              *data_return);
15
16       int XDeleteContext(Display *display, XID rid, XContext context);
17
18       XContext XUniqueContext(void);
19

ARGUMENTS

21       context   Specifies the context type to which the data belongs.
22
23       data      Specifies the data to be associated with the window and type.
24
25       data_return
26                 Returns the data.
27
28       display   Specifies the connection to the X server.
29
30       rid       Specifies the resource ID with which the data is associated.
31

DESCRIPTION

33       If an entry with the specified resource ID and type already exists,
34       XSaveContext overrides it with the specified context.  The XSaveContext
35       function returns a nonzero error code if an error has occurred and zero
36       otherwise.  Possible errors are XCNOMEM (out of memory).
37
38       Because it is a return value, the data is a pointer.  The XFindContext
39       function returns a nonzero error code if an error has occurred and zero
40       otherwise.  Possible errors are XCNOENT (context-not-found).
41
42       The XDeleteContext function deletes the entry for the given resource ID
43       and type from the data structure.  This function returns the same error
44       codes that XFindContext returns if called with the same arguments.
45       XDeleteContext does not free the data whose address was saved.
46
47       The XUniqueContext function creates a unique context type that may be
48       used in subsequent calls to XSaveContext.
49

SEE ALSO

51       Xlib - C Language X Interface
52
53
54
55X Version 11                     libX11 1.6.5                  XSaveContext(3)
Impressum