hashPtr.h File Reference

#include <stdio.h>
#include "misc/extra/extra.h"

Go to the source code of this file.

Data Structures
struct	Hash_Ptr_Entry_t_
struct	Hash_Ptr_t_

Macros
#define	Hash_PtrForEachEntry(pHash, pEntry, bin)
	MACRO DEFINITIONS ///. More...

Typedefs
typedef struct Hash_Ptr_t_	Hash_Ptr_t
	PARAMETERS ///. More...
typedef struct Hash_Ptr_Entry_t_	Hash_Ptr_Entry_t

Functions
ABC_NAMESPACE_HEADER_START int	Hash_DefaultHashFunc (int key, int nBins)
	INCLUDES ///. More...
static Hash_Ptr_t *	Hash_PtrAlloc (int nBins)
	FUNCTION DEFINITIONS ///. More...
static int	Hash_PtrExists (Hash_Ptr_t *p, int key)
static void	Hash_PtrWriteEntry (Hash_Ptr_t *p, int key, void *data)
static void *	Hash_PtrEntry (Hash_Ptr_t *p, int key, int fCreate)
static void **	Hash_PtrEntryPtr (Hash_Ptr_t *p, int key)
static void *	Hash_PtrRemove (Hash_Ptr_t *p, int key)
static void	Hash_PtrFree (Hash_Ptr_t *p)

Macro Definition Documentation

#define Hash_PtrForEachEntry	(		pHash,
			pEntry,
			bin
	)

Value:

for(bin=-1, pEntry=NULL; bin < pHash->nBins; (!pEntry)?(pEntry=pHash->pArray[++bin]):(pEntry=pEntry->pNext)) \
    if (pEntry)

MACRO DEFINITIONS ///.

Definition at line 69 of file hashPtr.h.

Typedef Documentation

typedef struct Hash_Ptr_Entry_t_ Hash_Ptr_Entry_t

Definition at line 46 of file hashPtr.h.

typedef struct Hash_Ptr_t_ Hash_Ptr_t

PARAMETERS ///.

BASIC TYPES ///

Definition at line 45 of file hashPtr.h.

Function Documentation

ABC_NAMESPACE_HEADER_START int Hash_DefaultHashFunc	(	int	key,
		int	nBins
	)

INCLUDES ///.

CFile****************************************************************

FileName [hashFlt.h]

SystemName [ABC: Logic synthesis and verification system.]

PackageName [Hash maps.]

Synopsis [Hash maps.]

Author [Aaron P. Hurst]

Affiliation [UC Berkeley]

Date [Ver. 1.0. Started - May 16, 2006.]

Revision [

Id:

vecInt.h,v 1.00 2005/06/20 00:00:00 ahurst Exp

]

CFile****************************************************************

FileName [hash.h]

SystemName [ABC: Logic synthesis and verification system.]

PackageName [Hash map.]

Synopsis [External declarations.]

Author [Aaron P. Hurst]

Affiliation [UC Berkeley]

Date [Ver. 1.0. Started - May 16, 2005.]

Revision [

Id:

vec.h,v 1.00 2005/06/20 00:00:00 ahurst Exp

]PARAMETERS ///BASIC TYPES ///MACRO DEFINITIONS ///FUNCTION DECLARATIONS ///

Definition at line 57 of file hash.h.

                                             {
  return Abc_AbsInt( ( (key+11)*(key)*7+3 ) % nBins );
}

static Hash_Ptr_t* Hash_PtrAlloc ( int  nBins )

inlinestatic

FUNCTION DEFINITIONS ///.

Function*************************************************************

Synopsis [Allocates a hash map with the given number of bins.]

Description []

SideEffects []

SeeAlso []

Definition at line 88 of file hashPtr.h.

{
  Hash_Ptr_t * p;
  int i;
  assert(nBins > 0);
  p = ABC_ALLOC( Hash_Ptr_t, 1);
  p->nBins = nBins;
  p->fHash = Hash_DefaultHashFunc;
  p->nSize  = 0;
  p->pArray = ABC_ALLOC( Hash_Ptr_Entry_t *, nBins );
  for(i=0; i<nBins; i++)
    p->pArray[i] = NULL;

  return p;
}

static void* Hash_PtrEntry ( Hash_Ptr_t *  p, int  key, int  fCreate  )

inlinestatic

Function*************************************************************

Synopsis [Finds or creates an entry with a key.]

Description [fCreate specifies whether a new entry should be created.]

SideEffects []

SeeAlso []

Definition at line 189 of file hashPtr.h.

{
  int bin;
  Hash_Ptr_Entry_t *pEntry, **pLast;

  // find the bin where this key would live
  bin = (*(p->fHash))(key, p->nBins);

  // search for key
  pLast = &(p->pArray[bin]);
  pEntry = p->pArray[bin];
  while(pEntry) {
    if (pEntry->key == key)
      return pEntry->data;
    pLast = &(pEntry->pNext);
    pEntry = pEntry->pNext;
  }

  // this key does not currently exist
  if (fCreate) {
    // create a new entry and add to bin
    p->nSize++;
    (*pLast) = pEntry = ABC_ALLOC( Hash_Ptr_Entry_t, 1 );
    pEntry->pNext = NULL;
    pEntry->key = key;
    pEntry->data = NULL;
    return pEntry->data;
  }

  return NULL;
}

static void** Hash_PtrEntryPtr ( Hash_Ptr_t *  p, int  key  )

inlinestatic

Function*************************************************************

Synopsis [Finds or creates an entry with a key and returns the pointer to it.]

Description []

SideEffects []

SeeAlso []

Definition at line 233 of file hashPtr.h.

{
  int bin;
  Hash_Ptr_Entry_t *pEntry, **pLast;

  // find the bin where this key would live
  bin = (*(p->fHash))(key, p->nBins);

  // search for key
  pLast = &(p->pArray[bin]);
  pEntry = p->pArray[bin];
  while(pEntry) {
    if (pEntry->key == key)
      return &(pEntry->data);
    pLast = &(pEntry->pNext);
    pEntry = pEntry->pNext;
  }

  // this key does not currently exist
  // create a new entry and add to bin
  p->nSize++;
  (*pLast) = pEntry = ABC_ALLOC( Hash_Ptr_Entry_t, 1 );
  pEntry->pNext = NULL;
  pEntry->key = key;
  pEntry->data = NULL;

  return &(pEntry->data);
}

static int Hash_PtrExists ( Hash_Ptr_t *  p, int  key  )

inlinestatic

Function*************************************************************

Synopsis [Returns 1 if a key already exists.]

Description []

SideEffects []

SeeAlso []

Definition at line 115 of file hashPtr.h.

{
  int bin;
  Hash_Ptr_Entry_t *pEntry;

  // find the bin where this key would live
  bin = (*(p->fHash))(key, p->nBins);

  // search for key
  pEntry = p->pArray[bin];
  while(pEntry) {
    if (pEntry->key == key) {
      return 1;
    }
    pEntry = pEntry->pNext;
  }

  return 0;
}

static void Hash_PtrFree ( Hash_Ptr_t *  p )

inlinestatic

Function*************************************************************

Synopsis [Frees the hash.]

Description []

SideEffects []

SeeAlso []

Definition at line 311 of file hashPtr.h.

{
  int bin;
  Hash_Ptr_Entry_t *pEntry, *pTemp;

  // free bins
  for(bin = 0; bin < p->nBins; bin++) {
    pEntry = p->pArray[bin];
    while(pEntry) {
      pTemp = pEntry;
      pEntry = pEntry->pNext;
      ABC_FREE( pTemp );
    }
  }
 
  // free hash
  ABC_FREE( p->pArray );
  ABC_FREE( p );
}

static void* Hash_PtrRemove ( Hash_Ptr_t *  p, int  key  )

inlinestatic

Function*************************************************************

Synopsis [Deletes an entry.]

Description [Returns data, if there was any.]

SideEffects []

SeeAlso []

Definition at line 273 of file hashPtr.h.

{
  int    bin;
  void * data;
  Hash_Ptr_Entry_t *pEntry, **pLast;

  // find the bin where this key would live
  bin = (*(p->fHash))(key, p->nBins);

  // search for key
  pLast = &(p->pArray[bin]);
  pEntry = p->pArray[bin];
  while(pEntry) {
    if (pEntry->key == key) {
      p->nSize--;
      data = pEntry->data;
      *pLast = pEntry->pNext;
      return data;
    }
    pLast = &(pEntry->pNext);
    pEntry = pEntry->pNext;
  }
    
  // could not find key
  return NULL;
}

static void Hash_PtrWriteEntry ( Hash_Ptr_t *  p, int  key, void *  data  )

inlinestatic

Function*************************************************************

Synopsis [Finds or creates an entry with a key and writes value.]

Description []

SideEffects []

SeeAlso []

Definition at line 146 of file hashPtr.h.

{
  int bin;
  Hash_Ptr_Entry_t *pEntry, **pLast;

  // find the bin where this key would live
  bin = (*(p->fHash))(key, p->nBins);

  // search for key
  pLast = &(p->pArray[bin]);
  pEntry = p->pArray[bin];
  while(pEntry) {
    if (pEntry->key == key) {
      pEntry->data = data;
      return;
    }
    pLast = &(pEntry->pNext);
    pEntry = pEntry->pNext;
  }

  // this key does not currently exist
  // create a new entry and add to bin
  p->nSize++;
  (*pLast) = pEntry = ABC_ALLOC( Hash_Ptr_Entry_t, 1 );
  pEntry->pNext = NULL;
  pEntry->key = key;
  pEntry->data = data;

  return;
}