hashtable.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Defines
#define	DEFINE_HASHTABLE_INSERT(fnname, keytype, valuetype)
#define	DEFINE_HASHTABLE_SEARCH(fnname, keytype, valuetype)
#define	DEFINE_HASHTABLE_REMOVE(fnname, keytype, valuetype)
Functions
hashtable *	create_hashtable (unsigned int minsize, unsigned int(*hashfunction)(void *), int(*key_eq_fn)(void *, void *))
int	hashtable_insert (struct hashtable *h, void *k, void *v)
void *	hashtable_search (struct hashtable *h, void *k)
void *	hashtable_remove (struct hashtable *h, void *k)
unsigned int	hashtable_count (struct hashtable *h)
void	hashtable_destroy (struct hashtable *h, int free_values)

---

Define Documentation

#define DEFINE_HASHTABLE_INSERT	(	fnname,
		keytype,
		valuetype		)

Value:

int fnname (struct hashtable *h, keytype *k, valuetype *v) \
{ \
    return hashtable_insert(h,k,v); \
}

Definition at line 132 of file hashtable.h.

#define DEFINE_HASHTABLE_REMOVE	(	fnname,
		keytype,
		valuetype		)

Value:

valuetype * fnname (struct hashtable *h, keytype *k) \
{ \
    return (valuetype *) (hashtable_remove(h,k)); \
}

Definition at line 168 of file hashtable.h.

#define DEFINE_HASHTABLE_SEARCH	(	fnname,
		keytype,
		valuetype		)

Value:

valuetype * fnname (struct hashtable *h, keytype *k) \
{ \
    return (valuetype *) (hashtable_search(h,k)); \
}

Definition at line 150 of file hashtable.h.

---

Function Documentation

struct hashtable* create_hashtable	(	unsigned int	minsize,
		unsigned int(*)(void *)	hashfunction,
		int(*)(void *, void *)	key_eq_fn
	)

Definition at line 62 of file hashtable.c.

References FREE, h, MALLOC, NULL, prime_table_length, and size.

Referenced by createGetHashTable(), CreateHashtable_string(), createSetHashTable(), and myhcreate().

{
    struct hashtable *h;
    unsigned int pindex, size = primes[0];
    /* Check requested hashtable isn't too large */
    if (minsize > (1u << 30)) return NULL;
    /* Enforce size as prime */
    for (pindex=0; pindex < prime_table_length; pindex++) {
        if (primes[pindex] > minsize) { size = primes[pindex]; break; }
    }
    h = (struct hashtable *)MALLOC(sizeof(struct hashtable));
    if (NULL == h) return NULL; /*oom*/
    h->table = (struct entry **)MALLOC(sizeof(struct entry*) * size);
    if (NULL == h->table) { FREE(h); return NULL; } /*oom*/
    memset(h->table, 0, size * sizeof(struct entry *));
    h->tablelength  = size;
    h->primeindex   = pindex;
    h->entrycount   = 0;
    h->hashfn       = hashf;
    h->eqfn         = eqf;
    h->loadlimit    = (unsigned int) ceil(size * max_load_factor);
    return h;
}

Here is the caller graph for this function:

unsigned int hashtable_count

(

struct hashtable *

h

)

Definition at line 162 of file hashtable.c.

References h.

{
    return h->entrycount;
}

void hashtable_destroy	(	struct hashtable *	h,
		int	free_values
	)

Definition at line 251 of file hashtable.c.

References f(), FREE, freekey, h, entry::next, NULL, and table.

Referenced by destroyGetHashTable(), DestroyHashtable_string(), destroySetHashTable(), DisposeHashTableScilabErrors(), DisposeHashTableScilabMenus(), DisposeHashTableScilabMessages(), and myhdestroy().

{
    unsigned int i;
    struct entry *e, *f;
    struct entry **table = h->table;
    if (free_values)
    {
        for (i = 0; i < h->tablelength; i++)
        {
            e = table[i];
            while (NULL != e)
            { f = e; e = e->next; freekey(f->k); FREE(f->v); FREE(f); }
        }
    }
    else
    {
        for (i = 0; i < h->tablelength; i++)
        {
            e = table[i];
            while (NULL != e)
            { f = e; e = e->next; freekey(f->k); FREE(f); }
        }
    }
    FREE(h->table);
    FREE(h);
}

Here is the call graph for this function:

Here is the caller graph for this function:

int hashtable_insert	(	struct hashtable *	h,
		void *	k,
		void *	v
	)

Definition at line 169 of file hashtable.c.

References entry::h, h, hash(), hashtable_expand(), indexFor(), entry::k, MALLOC, entry::next, NULL, and entry::v.

Referenced by insertGetHashtable(), InsertHashtable_string(), and insertSetHashtable().

{
    /* This method allows duplicate keys - but they shouldn't be used */
    unsigned int index_;
    struct entry *e;
    if (++(h->entrycount) > h->loadlimit)
    {
        /* Ignore the return value. If expand fails, we should
         * still try cramming just this value into the existing table
         * -- we may not have memory for a larger table, but one more
         * element may be ok. Next time we insert, we'll try expanding again.*/
        hashtable_expand(h);
    }
    e = (struct entry *)MALLOC(sizeof(struct entry));
    if (NULL == e) { --(h->entrycount); return 0; } /*oom*/
    e->h = hash(h,k);
    index_ = indexFor(h->tablelength,e->h);
    e->k = k;
    e->v = v;
    e->next = h->table[index_];
    h->table[index_] = e;
    return -1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void* hashtable_remove	(	struct hashtable *	h,
		void *	k
	)

Definition at line 217 of file hashtable.c.

References FREE, freekey, entry::h, h, hash(), indexFor(), entry::k, entry::next, NULL, entry::v, and v.

Referenced by RemoveHastable_string().

{
    /* TODO: consider compacting the table when the load factor drops enough,
     *       or provide a 'compact' method. */

    struct entry *e;
    struct entry **pE;
    void *v;
    unsigned int hashvalue, index_;

    hashvalue = hash(h,k);
    index_ = indexFor(h->tablelength,hash(h,k));
    pE = &(h->table[index_]);
    e = *pE;
    while (NULL != e)
    {
        /* Check hash value to short circuit heavier comparison */
        if ((hashvalue == e->h) && (h->eqfn(k, e->k)))
        {
            *pE = e->next;
            h->entrycount--;
            v = e->v;
            freekey(e->k);
            FREE(e);
            return v;
        }
        pE = &(e->next);
        e = e->next;
    }
    return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void* hashtable_search	(	struct hashtable *	h,
		void *	k
	)

Definition at line 195 of file hashtable.c.

References entry::h, h, hash(), indexFor(), entry::k, entry::next, NULL, and entry::v.

Referenced by searchGetHashtable(), SearchHashtable_string(), and searchSetHashtable().

{
    struct entry *e;
    unsigned int hashvalue, index_;
    hashvalue = hash(h,k);
    index_ = indexFor(h->tablelength,hashvalue);
    e = h->table[index_];
    while (NULL != e)
    {
        /* Check hash value to short circuit heavier comparison */
        if ((hashvalue == e->h) && (h->eqfn(k, e->k))) 
                {
                        return e->v;
                }
                        
        e = e->next;
    }
    return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

---