bionic (3) addhtitem.3.gz

NAME

       addhtitem - adds a new item in a hash table.

SYNOPSYS

       #include "mut.h"
       void addhtitem(table, key, value)
       ht ∗table;
       void ∗key;
       int value;

PARAMETERS

       table               Hash table pointer

       key                 Key used by the hash coding function to add the item

       value               Value associated with the key

DESCRIPTION

       addhtitem()  adds  a  new item in the hash table pointed to by table.  If the key already exists, the old
       value is changed to the new one.  Value must be distinct from EMPTYHT and DELETEHT.  The  length  of  the
       table increases automatically when the length given in addht() leads to a performance shut down.

EXAMPLE

       #include "mut.h"
       #include "mlo.h"
       void conHenter(h, ptfig)
       ht ∗h;
       lofig_list ∗ptfig;
       {
       locon_list ∗ptcon;
          /∗ since connector names are unique, add them without check ∗/
          for (ptcon = p->LOCON; ptcon; ptcon = ptcon->NEXT)
             addhtitem(h, ptcon->NAME, 0);
       }

ERRORS

       "∗∗∗ mbk error ∗∗∗ addhtitem 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), gethtitem(3), sethtitem(3), delhtitem(3), viewht(3).