NAME

XMakeAssoc — create an entry in an association table. 

SYNOPSIS

XMakeAssoc(display, table, x_id, data) Display ∗display; XAssocTable ∗table;  XID x_id;  char ∗ data;

ARGUMENTS

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

tableSpecifies the association table in which an entry is to be made. 

x_idSpecifies the X resource ID. 

dataSpecifies the data to be associated with the X resource ID. 

DESCRIPTION

XMakeAssoc() inserts data into an XAssocTable keyed on an XID.  Association tables allow you to easily associate data with resource ID’s for later retrieval.  Association tables are local, accessible only by this client. 

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. 

Data is inserted into the table only once.  Redundant inserts are meaningless and cause no problems.  The queue in each association bucket is sorted from the lowest XID to the highest XID. 

For more information, see Volume One, Appendix B, X10 Compatibility. 

STRUCTURE

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(), XLookUpAssoc(). 

Xlib Reference Manual