XSaveContext(3X11)                             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 win-
               dow and type.

     data_return
               Returns a pointer to the data.

     display   Specifies the connection to the XWIN server.

     w         Specifies the window with which the data is asso-
               ciated.

DESCRIPTION
     If an entry with the specified window 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).





XWIN 3.0               Last change: 9/1/88                 .ie t

XSaveContext(3X11)                             XSaveContext(3X11)



     The XDeleteContext function deletes the entry for the given
     window 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












































XWIN 3.0               Last change: 9/1/88                 .ie t

XSaveContext(3X11)                             XSaveContext(3X11)























































XWIN 3.0               Last change: 9/1/88                 .ie t