home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / evbl0627.zip / everblue_20010627.zip / x11 / Xlib_Context.c < prev    next >
C/C++ Source or Header  |  1999-11-02  |  9KB  |  327 lines
  1. /* $XConsortium: Context.c,v 1.21 94/04/17 20:18:54 rws Exp $ */
  2.  
  3. /***********************************************************
  4. Copyright 1987, 1988, 1990 by Digital Equipment Corporation, Maynard,
  5.  
  6.                         All Rights Reserved
  7.  
  8. Permission to use, copy, modify, and distribute this software and its 
  9. documentation for any purpose and without fee is hereby granted, 
  10. provided that the above copyright notice appear in all copies and that
  11. both that copyright notice and this permission notice appear in 
  12. supporting documentation, and that the name Digital not be
  13. used in advertising or publicity pertaining to distribution of the
  14. software without specific, written prior permission.  
  15.  
  16. DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  17. ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  18. DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  19. ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  20. WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
  21. ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  22. SOFTWARE.
  23.  
  24. ******************************************************************/
  25.  
  26. /*
  27.  
  28. Copyright (c) 1987, 1988, 1990, 1994  X Consortium
  29.  
  30. Permission is hereby granted, free of charge, to any person obtaining
  31. a copy of this software and associated documentation files (the
  32. "Software"), to deal in the Software without restriction, including
  33. without limitation the rights to use, copy, modify, merge, publish,
  34. distribute, sublicense, and/or sell copies of the Software, and to
  35. permit persons to whom the Software is furnished to do so, subject to
  36. the following conditions:
  37.  
  38. The above copyright notice and this permission notice shall be included
  39. in all copies or substantial portions of the Software.
  40.  
  41. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  42. OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  43. MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
  44. IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
  45. OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  46. ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  47. OTHER DEALINGS IN THE SOFTWARE.
  48.  
  49. Except as contained in this notice, the name of the X Consortium shall
  50. not be used in advertising or otherwise to promote the sale, use or
  51. other dealings in this Software without prior written authorization
  52. from the X Consortium.
  53.  
  54. */
  55.  
  56. /* This module implements a simple sparse array.
  57.  
  58.    XSaveContext(a,b,c,d) will store d in position (a,b,c) of the array.
  59.    XFindContext(a,b,c,&d) will set d to be the value in position (a,b,c).
  60.    XDeleteContext(a,b,c) will delete the entry in (a,b,c).
  61.  
  62.    a is a display id, b is a resource id, and c is a Context.  d is just an
  63.    XPointer.  This code will work with any range of parameters, but is geared
  64.    to be most efficient with very few (one or two) different a's.
  65.  
  66. */
  67.  
  68. #include "Xlib_private.h"
  69. #include "X11/Xutil.h"
  70. #ifdef XTHREADS
  71. #include "locking.h"
  72. #endif
  73.  
  74. #define INITHASHMASK 63 /* Number of entries originally in the hash table. */
  75.  
  76. typedef struct _TableEntryRec {    /* Stores one entry. */
  77.     XID             rid;
  78.     XContext            context;
  79.     XPointer            data;
  80.     struct _TableEntryRec    *next;
  81. } TableEntryRec, *TableEntry;
  82.  
  83. typedef struct _XContextDB {    /* Stores hash table for one display. */
  84.     TableEntry *table;        /* Pointer to array of hash entries. */
  85.     int mask;            /* Current size of hash table minus 1. */
  86.     int numentries;        /* Number of entries currently in table. */
  87. #ifdef XTHREADS
  88.     LockInfoRec linfo;
  89. #endif
  90. } DBRec, *DB;
  91.  
  92. #ifdef MOTIFBC
  93. static DB NullDB = (DB)0;
  94. #endif
  95.  
  96. /* Given an XID and a context, returns a value between 0 and HashSize-1.
  97.    Currently, this requires that HashSize be a power of 2.
  98. */
  99.  
  100. #define Hash(db,rid,context) \
  101.     (db)->table[(((rid) << 1) + context) & (db)->mask]
  102.  
  103. /* Resize the given db */
  104.  
  105. static void ResizeTable(db)
  106.     register DB db;
  107. {
  108.     DBUG_ENTER("ResizeTable")
  109.     TableEntry *otable;
  110.     register TableEntry entry, next, *pold, *head;
  111.     register int i, j;
  112.  
  113.     otable = db->table;
  114.     for (i = INITHASHMASK+1; (i + i) < db->numentries; )
  115.     i += i;
  116.     db->table = (TableEntry *) Xcalloc((unsigned)i, sizeof(TableEntry));
  117.     if (!db->table) {
  118.     db->table = otable;
  119.     DBUG_VOID_RETURN;
  120.     }
  121.     j = db->mask + 1;
  122.     db->mask = i - 1;
  123.     for (pold = otable ; --j >= 0; pold++) {
  124.     for (entry = *pold; entry; entry = next) {
  125.         next = entry->next;
  126.         head = &Hash(db, entry->rid, entry->context);
  127.         entry->next = *head;
  128.         *head = entry;
  129.     }
  130.     }
  131.     Xfree((char *) otable);
  132.     DBUG_VOID_RETURN;
  133. }
  134.  
  135. static void _XFreeContextDB(display)
  136.     Display *display;
  137. {
  138.     DBUG_ENTER("_XFreeContextDB")
  139.     register DB db;
  140.     register int i;
  141.     register TableEntry *pentry, entry, next;
  142.  
  143.     db = display->context_db;
  144.     if (db) {
  145.     for (i = db->mask + 1, pentry = db->table ; --i >= 0; pentry++) {
  146.         for (entry = *pentry; entry; entry = next) {
  147.         next = entry->next;
  148.         Xfree((char *)entry);
  149.         }
  150.     }
  151.     Xfree((char *) db->table);
  152.     _XFreeMutex(&db->linfo);
  153.     Xfree((char *) db);
  154.     }
  155.     DBUG_VOID_RETURN;
  156. }
  157.  
  158. /* Public routines. */
  159.  
  160. /* Save the given value of data to correspond with the keys XID and context.
  161.    Returns nonzero error code if an error has occured, 0 otherwise.
  162.    Possible errors are Out-of-memory.
  163. */   
  164.  
  165. #if NeedFunctionPrototypes
  166. int XSaveContext(
  167.     Display *display,
  168.     register XID rid,
  169.     register XContext context,
  170.     _Xconst char* data)
  171. #else
  172. int XSaveContext(display, rid, context, data)
  173.     Display *display;
  174.     register XID rid;
  175.     register XContext context;
  176.     XPointer data;
  177. #endif
  178. {
  179.     DBUG_ENTER("XSaveContext")
  180.     DB *pdb;
  181.     register DB db;
  182.     TableEntry *head;
  183.     register TableEntry entry;
  184.  
  185. #ifdef MOTIFBC
  186.     if (!display) {
  187.     pdb = &NullDB;
  188.     db = *pdb;
  189.     } else
  190. #endif
  191.     {
  192.     LockDisplay(display);
  193.     pdb = &display->context_db;
  194.     db = *pdb;
  195.     UnlockDisplay(display);
  196.     }
  197.     if (!db) {
  198.     db = (DB) Xmalloc(sizeof(DBRec));
  199.     if (!db)
  200.         DBUG_RETURN(XCNOMEM);
  201.     db->mask = INITHASHMASK;
  202.     db->table = (TableEntry *)Xcalloc(db->mask + 1, sizeof(TableEntry));
  203.     if (!db->table) {
  204.         Xfree((char *)db);
  205.         DBUG_RETURN(XCNOMEM);
  206.     }
  207.     db->numentries = 0;
  208.     _XCreateMutex(&db->linfo);
  209. #ifdef MOTIFBC
  210.     if (!display) *pdb = db; else
  211. #endif
  212.     {
  213.         LockDisplay(display);
  214.         *pdb = db;
  215.         display->free_funcs->context_db = _XFreeContextDB;
  216.         UnlockDisplay(display);
  217.     }
  218.     }
  219.     _XLockMutex(&db->linfo);
  220.     head = &Hash(db, rid, context);
  221.     _XUnlockMutex(&db->linfo);
  222.     for (entry = *head; entry; entry = entry->next) {
  223.     if (entry->rid == rid && entry->context == context) {
  224.         entry->data = (XPointer)data;
  225.         DBUG_RETURN(0);
  226.     }
  227.     }
  228.     entry = (TableEntry) Xmalloc(sizeof(TableEntryRec));
  229.     if (!entry)
  230.     DBUG_RETURN(XCNOMEM);
  231.     entry->rid = rid;
  232.     entry->context = context;
  233.     entry->data = (XPointer)data;
  234.     entry->next = *head;
  235.     *head = entry;
  236.     _XLockMutex(&db->linfo);
  237.     db->numentries++;
  238.     if (db->numentries > (db->mask << 2))
  239.     ResizeTable(db);
  240.     _XUnlockMutex(&db->linfo);
  241.     DBUG_RETURN(0);
  242. }
  243.  
  244.  
  245.  
  246. /* Given an XID and context, returns the associated data.  Note that data 
  247.    here is a pointer since it is a return value.  Returns nonzero error code
  248.    if an error has occured, 0 otherwise.  Possible errors are Entry-not-found.
  249. */
  250.  
  251. int XFindContext(display, rid, context, data)
  252.     Display *display;
  253.     register XID rid;
  254.     register XContext context;
  255.     XPointer *data;        /* RETURN */
  256. {
  257.     DBUG_ENTER("XFindContext")
  258.     register DB db;
  259.     register TableEntry entry;
  260.  
  261. #ifdef MOTIFBC
  262.     if (!display) db = NullDB; else
  263. #endif
  264.     {
  265.     LockDisplay(display);
  266.     db = display->context_db;
  267.     UnlockDisplay(display);
  268.     }
  269.     if (!db)
  270.     DBUG_RETURN(XCNOENT);
  271.     _XLockMutex(&db->linfo);
  272.     for (entry = Hash(db, rid, context); entry; entry = entry->next)
  273.     {
  274.     if (entry->rid == rid && entry->context == context) {
  275.         *data = (XPointer)entry->data;
  276.         _XUnlockMutex(&db->linfo);
  277.         DBUG_RETURN(0);
  278.     }
  279.     }
  280.     _XUnlockMutex(&db->linfo);
  281.     DBUG_RETURN(XCNOENT);
  282. }
  283.  
  284.  
  285.  
  286. /* Deletes the entry for the given XID and context from the datastructure.
  287.    This returns the same thing that FindContext would have returned if called
  288.    with the same arguments.
  289. */
  290.  
  291. int XDeleteContext(display, rid, context)
  292.     Display *display;
  293.     register XID rid;
  294.     register XContext context;
  295. {
  296.     DBUG_ENTER("XDeleteContext")
  297.     register DB db;
  298.     register TableEntry entry, *prev;
  299.  
  300. #ifdef MOTIFBC
  301.     if (!display) db = NullDB; else
  302. #endif
  303.     {
  304.     LockDisplay(display);
  305.     db = display->context_db;
  306.     UnlockDisplay(display);
  307.     }
  308.     if (!db)
  309.     DBUG_RETURN(XCNOENT);
  310.     _XLockMutex(&db->linfo);
  311.     for (prev = &Hash(db, rid, context);
  312.      (entry = *prev);
  313.      prev = &entry->next) {
  314.     if (entry->rid == rid && entry->context == context) {
  315.         *prev = entry->next;
  316.         Xfree((char *) entry);
  317.         db->numentries--;
  318.         if (db->numentries < db->mask && db->mask > INITHASHMASK)
  319.         ResizeTable(db);
  320.         _XUnlockMutex(&db->linfo);
  321.         DBUG_RETURN(0);
  322.     }
  323.     }
  324.     _XUnlockMutex(&db->linfo);
  325.     DBUG_RETURN(XCNOENT);
  326. }
  327.