xuniquecontext(3x11) [ultrix man page]

XSaveContext(3X11)						     MIT X11R4							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, overrides it with the specified context.	The function returns a nonzero
       error code if an error has occurred and zero otherwise.	Possible errors are (out of memory).

       Because it is a return value, the data is a pointer.  The function returns a nonzero error code if an error has occurred and zero other-
       wise.  Possible errors are (context-not-found).

       The function deletes the entry for the given window and type from the data structure.  This function returns the same error codes that
       returns if called with the same arguments.  does not free the data whose address was saved.

       The function creates a unique context type that may be used in subsequent calls to

See Also
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

																XSaveContext(3X11)

XSaveContext(3X11)						  XLIB FUNCTIONS						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, data_return)
	     Display *display;
	     XID rid;
	     XContext context;
	     XPointer *data_return;

       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.

       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.

SEE ALSO

       Xlib - C Language X Interface

X Version 11							    Release 6.6 						XSaveContext(3X11)