xlookupassoc(3) [hpux man page]

XLookUpAssoc()															    XLookUpAssoc()

Name
  XLookUpAssoc - obtain data from an association table.

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

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  table     Specifies the association table.

  x_id	    Specifies 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;

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

Xlib - Association Tables													    XLookUpAssoc()

XtGetKeysymTable()														XtGetKeysymTable()

Name
  XtGetKeysymTable - return a pointer to the keycode-to-keysym mapping table of a  display.

Synopsis
  KeySym *XtGetKeysymTable(display, min_keycode_return,
  keysyms_per_keycode_return)
	   Display *display;
	   KeyCode *min_keycode_return;
	   int *keysyms_per_keycode_return;

Inputs
  display   Specifies the display whose table is required.

Outputs
  min_keycode_return
	    Returns the minimum keycode valid for the display.

  keysyms_per_keycode_return
	    Returns the number of keysyms stored for each keycode.

Returns
  The keycode-to-keysym table for display.

Availability
  Release 4 and later.

Description
  XtGetKeysymTable()  returns  a pointer to the Intrinsics' copy of the X server's keycode-to-keysym table, which must not be modified by the
  application.	This table is simply an array of KeySym.  The number of keysyms associated with each keycode is returned in  keysyms_per_key-
  code_return.	 The  first  keysyms  in  the table are for the keycode returned in min_keycode_return.  The keysyms for a keycode k begin at
  index:

     k - min_keycode_return) * keysyms_per_keycode_return

  Any entries in the table that have no keysyms associated with them contain the value NoSymbol.

Usage
  The Intrinsics maintains a table internally to map keycodes to keysyms for each open display.  The Translation Manager uses this table, and
  custom keycode-to-keysym translator procedures (see XtSetKeyTranslator()) and other clients may also need to use it.	Most applications and
  widgets will never need to use this function.

  You should not cache this keysym table but should call XtGetKeysymTable() each time the value is needed, because the table  may  change  at
  any time.

See Also
  XtConvertCase(1), XtKeysymToKeycodeList(1), XtRegisterCaseConverter(1), XtSetKeyTranslator(1), XtTranslateKeycode(1).

Xt - Keyboard Handling														XtGetKeysymTable()