viewht(3) [debian man page]

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

NAME

       viewht - displays a hash table contents

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"
       void viewht(table, display)
       ht *table;
       char *(*display)();

PARAMETER

       table		   Hash table to be viewed

       display		   Function to be used for displaying an item of the table This function needs a user supplied parameter, the  pointer	to
			   the item.

DESCRIPTION

       viewht() displays all items of table :

       index		   This is the entry index of the hash table

       key		   This pointer is the one given by the user.  It is displayed using something like
			   fprintf(stdout, "%s
", display(key));.

       value		   This is the value associated with the key.  It is displayed as an int.

EXAMPLE

       #include "mut.h"
       #include <stdio.h>
       typedef struct of_fp {
	  char *name;
	  float f;
	  void *p;
       } fp;
       char *printout(s)
       fp *s;
       {
       char t[BUFSIZ];
	  sprintf(t, "name : `%s' :~~~: float value : `%.6f' <%#x>",
	     s->name, s->f, s->p);
	  return t;
       }
       void displayall(h)
       ht *h;
       {
	  viewht(h, printout);
       }

SEE ALSO

       mbk(1), addht(3), delht(3), addhtitem(3), gethtitem(3), sethtitem(3), delhtitem(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							 VIEWHT(3)

NAMEALLOC(3)						       MBK UTILITY FUNCTIONS						      NAMEALLOC(3)

NAME

       namealloc - hash table for strings

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"
       char *namealloc(inputname)
       char *inputname;

PARAMETER

       inputname	   Pointer to a string of characters

DESCRIPTION

       The namealloc function creates a dictionnary of names in mbk.  It warranties equality on characters string if the pointers to these strings
       are equal, at strcmp(3) meaning. This means also that there is a single memory address for a given string.
       The  case  of  the  letters do not matter. All names are changed to lower case before beeing introduced in the symbol table. This is needed
       because most of the file format do not check case.
       namealloc is used by all mbk utility function using names, so its use should be needed only when directly filling or  modifing  the  struc-
       ture, or when having to compare an external string to mbk internal ones. This should speed up string comparisons.
       One  shall  never  modify  the contains of a string pointed to by a result of namealloc, since all the field that points to this name would
       have there values modified, and that there is no chance that the new hash code will be the same as the old one, so pointer comparison would
       be meaningless. All string used by namealloc are constants string, and therefore must be left alone.

RETURN VALUE

       namealloc returns a string pointer.  If the inputname is already in the hash table, then its internal pointer is returned, else a new entry
       is created, and then the new pointer returned.

EXAMPLE

       #include "mut.h"
       #include "mlo.h"
       lofig_list *find_fig(name)
       char *name;
       {
       lofig_list *p;
	  name = namealloc(name);
	  for (p = HEAD_LOFIG; p; p = p->NEXT)
	     if (p->NAME == name) /* pointer equality */
		return p;
	  return NULL;
       }

DIAGNOSTICS

       namealloc can be used only after a call to mbkenv(3).

SEE ALSO

       mbk(1).

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						      NAMEALLOC(3)