LookUpAssoc(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

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.

RETURNS

The data from the association table.

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 XAssocTable 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;