XFindContext (3)
Leading comments
Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the foll...
NAME
XSaveContext, XFindContext, XDeleteContext, XUniqueContext - associative look-up routinesSYNTAX
- int XSaveContext(Display *display, XID rid, XContext context, XPointer data);
- int XFindContext(Display *display, XID rid, XContext context, XPointer *data_return);
- int XDeleteContext(Display *display, XID rid, XContext context);
XContext XUniqueContext(void);
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 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 saved.
The XUniqueContext function creates a unique context type that may be used in subsequent calls to XSaveContext.