debian man page for gethtitem

GETHTITEM(3)						MBK HASH TABLE MANAGEMENT FUNCTIONS					      GETHTITEM(3)

NAME
       gethtitem - searches an item in a hash table

ORIGIN
       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

SYNOPSYS
       #include "mut.h"
       int gethtitem(table, key)
       ht *table;
       void *key;

PARAMETERS
       table		   Hash table pointer

       key		   Key used by the hash coding function

DESCRIPTION
       gethtitem() searches an item in the hash table pointed to by table.

RETURN VALUE
       If the key key exists, the associated value is returned, if it doesn't, the function returns EMPTYHT.

EXAMPLE
       #include <stdio.h>
       #include "mut.h"
       check(p)
       losig_list *p;
       {
       char *amatla;
       losig_list *ptsig;
       locon_list *ptcon;
       ht *h;
	  for (i = 0, ptsig = p->LOSIG; ptsig; i++, ptsig = ptsig->NEXT);
	  h = addht(i);
	  /* two connectors can't have the same name! */
	  for (ptcon = p->LOCON; ptcon; ptcon = ptcon->NEXT)
	     addhtitem(h, ptcon->NAME, 0);
	  for (ptsig = p->LOSIG; ptsig; ptsig = ptsig->NEXT) {
	     if (ptsig->TYPE == INTERNAL) {
		amatla = getsigname(ptsig);
		/* this is nicely done with sethtitem! */
		if (gethtitem(h, amatla) == EMPTYHT) {
		   printf("N %s;
", amatla);
		   addhtitem(h, amatla, 0);
		}
	     }
	  }
	  delht();
       }

SEE ALSO
       mbk(1), addht(3), delht(3), addhtitem(3), delhtitem(3), viewht(3).

BUG REPORT
       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997						      GETHTITEM(3)