NAME

XLookUpAssoc − obtain data from an association table. 

Synopsis

char * XLookUpAssoc(display, table, x_id)
Display *display;
XAssocTable *table;
XID x_id;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

tableSpecifies the association table. 

x_idSpecifies the X resource ID. 

Description

This function is provided for compatibility with X Version 10.  To use it you must include the file <X11/X10.h> and link with the library -loldX.  Association tables provide a way of storing data locally and accessing by ID.  XLookUpAssoc() retrieves the data stored in an XAssoc­Table by its XID.  If the matching XID can be found in the table, the routine returns the data associated with it.  If the x_id cannot be found in the table the routine returns NULL.  For more information on association tables, see Volume One, Appendix B, X10 Compatibility. 

Structures

typedef struct {
    XAssoc *buckets;/* pointer to first bucket in bucket array */
    int size;/* table size (number of buckets) */
} XAssocTable;
 typedef struct _XAssoc {
struct _XAssoc *next;/* next object in this bucket */
struct _XAssoc *prev;/* previous object in this bucket */
Display *display;/* display which owns the ID */
XID x_id;/* X Window System ID */
char *data;/* pointer to untyped memory */
} XAssoc;

See Also

XCreateAssocTable(), XDeleteAssoc(), XDestroyAssocTable(), XMakeAssoc(). 

Copyright O’Reilly & Assoc.  —