sethtitem(3) [debian man page]

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

NAME

       sethtitem - test and set an item in an 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 sethtitem(table, key)
       ht *table;
       void *key;

PARAMETERS

       table		   Hash table pointer

       key		   Key used by the hash coding function to set an item

DESCRIPTION

       sethtitem() adds an item in the hash table pointed to by table, whether it existed or not, and returns an appropriate value.  This is  kind
       of a test and set operator.

RETURN VALUE

       If the key exists, the funtion return 1, if it doesn't, the item is stored and the function returns 0.

EXAMPLE

       #include <stdio.h>
       #include "mut.h"
       checksigname(p)
       lofig_list *p;
       {
       int i;
       losig_list *ptsig;
       locon_list *ptcon;
       ht *h;
       char *amatla;
	  for (i = 0, ptsig = p->LOSIG; ptsig; i++, ptsig = ptsig->NEXT);
	  h = addht(i << 1); /* half empty hash tables are faster! */
	  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);
		if (!sethtitem(h, amatla, 0))
		   printf("node %s is now unique
", amatla);
	     }
	  }
	  delht(h);
       }

ERRORS

       "*** mbk error *** sethtitem impossible : value is EMPTYHT or DELETEHT"
	      The values EMPTYHT, -1,  and DELETEHT, -2, are reserved for internal use, sorry.

DIAGNOSTICS

       The value must be distinct from -1 and -2.

SEE ALSO

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

ADDLOCON(3)						       MBK LOGICAL FUNCTIONS						       ADDLOCON(3)

NAME

       addlocon - create a logical connector

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 "mlo.h"
       locon_list *addlocon(ptfig, name, ptsig, dir)
       lofig_list *ptfig;
       char *name;
       losig_list *ptsig;
       char dir;

PARAMETERS

       ptfig		   Pointer to the figure in which the connector should be added

       name		   Name of the connector

       ptsig		   Pointer on the signal linked to the connector

       dir		   Connector direction type

DESCRIPTION

       addlocon creates a new figure connector called name and adds it to the list of connectors pointed to by ptfig->LOCON.  The new connector is
       added in front of the list, and becomes itself the list head.
       The parameters name, ptsig, dir, width fill respectivly the NAME, SIG and DIR fields of the locon structure. The name should be unique at a
       given hierarchical level since it's the connector identifier.
       The field TYPE is set to EXTERNAL since a cell connector is beeing created. The instance connectors are builded up by the addloins(3) call.
       See addloins(3) for details.  For a list of valid dir, see locon(3).

RETURN VALUE

       addlocon returns a pointer to the newly created connector.

ERRORS

       "*** mbk error *** addlocon impossible : connector name already exists in figure ptfig->NAME"
	      The name beeing the logical connector idenfier, two connectors may not have the same name in a given figure.
       "*** mbk error *** addlocon impossible : bad direction dir in figure ptfig->NAME"
	      The dir does not have a legal value. For the set of legal values, see locon(3).

EXAMPLE

       #include "mlo.h"
       locon_list *du_con(ptfig, ptcon) /* duplicate connector */
       lofig_list *ptfig;
       locon_list *ptcon;
       {
	  return addlocon(ptfig, ptcon->NAME, ptcon->SIG, ptcon->DIR);
       }

SEE ALSO

       mbk(1), locon(3), loins(3), lofig(3), getlocon(3), dellocon(3), phcon(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						       ADDLOCON(3)