2958N/A/***********************************************************************
2958N/A* *
2958N/A* This software is part of the ast package *
2958N/A* Copyright (c) 1985-2011 AT&T Intellectual Property *
2958N/A* and is licensed under the *
2958N/A* Eclipse Public License, Version 1.0 *
2958N/A* by AT&T Intellectual Property *
2958N/A* *
2958N/A* A copy of the License is available at *
2958N/A* http://www.eclipse.org/org/documents/epl-v10.html *
2958N/A* (with md5 checksum b35adb5213ca9657e911e9befb180842) *
2958N/A* *
2958N/A* Information and Software Systems Research *
2958N/A* AT&T Research *
2958N/A* Florham Park NJ *
2958N/A* *
2958N/A* Glenn Fowler <gsf@research.att.com> *
2958N/A* David Korn <dgk@research.att.com> *
2958N/A* Phong Vo <kpv@research.att.com> *
2958N/A* *
2958N/A***********************************************************************/
2958N/A#pragma prototyped
2958N/A/*
2958N/A * Glenn Fowler
2958N/A * AT&T Research
4495N/A *
2958N/A * hash table library interface definitions
2958N/A *
2958N/A * NOTE: new code should use the more general <cdt.h>
2958N/A */
2958N/A
2958N/A#ifndef _HASH_H
2958N/A#define _HASH_H
2958N/A
2958N/A#define HASH_ALLOCATE (1L<<0) /* allocate new key names */
2958N/A#define HASH_FIXED (1L<<1) /* fixed table size */
2958N/A#define HASH_HASHED (1L<<6) /* key names already hashed */
4495N/A#define HASH_RESIZE (1L<<2) /* table has been resized */
4495N/A#define HASH_SCANNING (1L<<3) /* currently scanning scope */
2958N/A#define HASH_SCOPE (1L<<4) /* push scope / create in bot */
4495N/A#define HASH_STATIC (1L<<5) /* static table allocation */
4495N/A
4495N/A#define HASH_CREATE (1L<<8) /* create bucket if not found */
4495N/A#define HASH_DELETE (1L<<9) /* delete bucket if found */
4495N/A#define HASH_LOOKUP 0 /* default op */
4495N/A#define HASH_RENAME (1L<<7) /* rename bucket if found */
4495N/A
4495N/A#define HASH_BUCKET (1L<<11) /* name is installed bucket */
4495N/A#define HASH_INSTALL (1L<<12) /* install allocated bucket */
4495N/A#define HASH_NOSCOPE (1L<<13) /* top scope only */
4495N/A#define HASH_OPAQUE (1L<<14) /* opaque bucket */
4495N/A#define HASH_VALUE (1L<<15) /* value bucket field used */
4495N/A
4495N/A#define HASH_SIZE(n) (((long)(n))<<16) /* fixed bucket size */
4495N/A#define HASH_SIZEOF(f) ((((long)(f))>>16)&0xffff) /* extract size */
4495N/A
4495N/A#define HASH_DELETED ((unsigned long)1<<(8*sizeof(int)-1)) /* deleted placeholder */
2958N/A#define HASH_KEEP (1L<<(8*sizeof(int)-2)) /* no free on bucket */
4495N/A#define HASH_HIDDEN (1L<<(8*sizeof(int)-3)) /* hidden by scope */
4495N/A#define HASH_HIDES (1L<<(8*sizeof(int)-4)) /* hides lower scope */
4495N/A#define HASH_OPAQUED (1L<<(8*sizeof(int)-5)) /* opaqued placeholder */
4495N/A#define HASH_FREENAME (1L<<(8*sizeof(int)-6)) /* free bucket name */
4495N/A
4495N/A#define HASH_RESET (HASH_RESIZE|HASH_SCOPE|HASH_STATIC|HASH_VALUE)
4495N/A#define HASH_INTERNAL (HASH_BUCKET|HASH_RESIZE|HASH_SCANNING|HASH_STATIC)
4495N/A#define HASH_FLAGS (HASH_DELETED|HASH_FREENAME|HASH_HIDDEN|HASH_HIDES|HASH_KEEP|HASH_OPAQUED)
4495N/A
4495N/A#define HASH_alloc 1
4495N/A#define HASH_clear 2
4495N/A#define HASH_compare 3
4495N/A#define HASH_free 4
4495N/A#define HASH_hash 5
4495N/A#define HASH_meanchain 6
4495N/A#define HASH_name 7
4495N/A#define HASH_namesize 8
4495N/A#define HASH_set 9
4495N/A#define HASH_size 10
4495N/A#define HASH_table 11
4495N/A#define HASH_va_list 12
4495N/A
4495N/A#define HASH_bucketsize 13
4495N/A
4495N/A#define HASH_region 14
4495N/A
4495N/A#include <hashpart.h>
4495N/A
4495N/A#define hashclear(t,f) ((t)->flags &= ~((f) & ~HASH_INTERNAL))
4495N/A#define hashcover(b) (((b)->hash&HASH_HIDES)?(Hash_bucket_t*)((b)->name):(Hash_bucket_t*)0)
4495N/A#define hashdel(t,n) hashlook(t, (char*)(n), HASH_DELETE, (char*)0)
4495N/A#define hashget(t,n) hashlook(t, (char*)(n), HASH_LOOKUP|HASH_VALUE, (char*)0)
4495N/A#define hashgetbucket(s) ((Hash_bucket_t*)((s)-((sizeof(Hash_bucket_t)+sizeof(char*)-1)/sizeof(char*))*sizeof(char*)))
4495N/A#define hashkeep(b) ((b)->hash|=HASH_KEEP)
4495N/A#define hashname(b) ((((b)->hash&HASH_HIDES)?((Hash_bucket_t*)((b)->name)):(b))->name)
4495N/A#define hashput(t,n,v) hashlook(t, (char*)(n), HASH_CREATE|HASH_VALUE, (char*)(v))
4495N/A#define hashref(t,n) hashlook(t, (char*)(n), HASH_LOOKUP|HASH_INTERNAL|HASH_VALUE, (char*)0)
4495N/A#define hashscope(t) ((t)->scope)
4495N/A#define hashset(t,f) ((t)->flags |= ((f) & ~HASH_INTERNAL))
4495N/A
4495N/A/*
4495N/A * DEPRECATED renames for compatibility
4495N/A */
4495N/A
4495N/A#define Hashbin_t Hash_bucket_t
4495N/A#define HASHBUCKET Hash_bucket_t
4495N/A#define Hashhdr_t Hash_header_t
4495N/A#define HASHHEADER Hash_header_t
4495N/A#define Hashpos_t Hash_position_t
4495N/A#define HASHPOSITION Hash_position_t
4495N/A#define Hashtab_t Hash_table_t
4495N/A#define HASHTABLE Hash_table_t
4495N/A
4495N/A#define vhashalloc hashvalloc
4495N/A#define hashvalloc(t,a) hashalloc(t,HASH_va_list,a,0)
4495N/A
4495N/A/*
4495N/A * the #define's avoid union tags
4495N/A */
4495N/A
4495N/Atypedef struct Hash_bucket Hash_bucket_t;
4495N/Atypedef struct Hash_root Hash_root_t;
4495N/Atypedef struct Hash_table Hash_table_t;
4495N/A
4495N/A#define HASH_HEADER /* common bucket header */ \
4495N/A Hash_bucket_t* next; /* next in collision chain */ \
4495N/A unsigned int hash; /* hash flags and value */ \
4495N/A char* name /* key name */
4495N/A
4495N/A#define HASH_DEFAULT /* HASH_VALUE bucket elements */ \
4495N/A char* value /* key value */
4495N/A
4495N/Atypedef struct /* bucket header */
4495N/A{
4495N/A HASH_HEADER;
4495N/A} Hash_header_t;
4495N/A
4495N/Astruct Hash_bucket /* prototype bucket */
4495N/A{
4495N/A HASH_HEADER;
4495N/A HASH_DEFAULT;
4495N/A};
4495N/A
4495N/Atypedef struct /* hash scan bucket position */
4495N/A{
4495N/A Hash_bucket_t* bucket; /* bucket */
4495N/A#ifdef _HASH_POSITION_PRIVATE_
4495N/A _HASH_POSITION_PRIVATE_
4495N/A#endif
4495N/A} Hash_position_t;
4495N/A
4495N/Atypedef struct /* last lookup cache */
4495N/A{
4495N/A Hash_table_t* table; /* last lookup table */
4495N/A Hash_bucket_t* bucket; /* last lookup bucket */
4495N/A#ifdef _HASH_LAST_PRIVATE_
4495N/A _HASH_LAST_PRIVATE_
4495N/A#endif
4495N/A} Hash_last_t;
4495N/A
4495N/Astruct Hash_root /* root hash table information */
4495N/A{
4495N/A int accesses; /* number of accesses */
4495N/A int collisions; /* number of collisions */
4495N/A int flags; /* flags: see HASH_[A-Z]* */
4495N/A Hash_last_t last; /* last lookup cache */
4495N/A void* context; /* user defined context */
4495N/A#ifdef _HASH_ROOT_PRIVATE_
4495N/A _HASH_ROOT_PRIVATE_
4495N/A#endif
4495N/A};
4495N/A
4495N/Astruct Hash_table /* hash table information */
4495N/A{
4495N/A Hash_root_t* root; /* root hash table information */
4495N/A int size; /* table size */
4495N/A int buckets; /* active bucket count */
4495N/A char* name; /* table name */
4495N/A Hash_table_t* scope; /* scope covered table */
4495N/A short flags; /* flags: see HASH_[A-Z]* */
4495N/A#ifdef _HASH_TABLE_PRIVATE_
4495N/A _HASH_TABLE_PRIVATE_
4495N/A#endif
4495N/A};
4495N/A
4495N/A#if _BLD_ast && defined(__EXPORT__)
4495N/A#define extern __EXPORT__
4495N/A#endif
4495N/A
4495N/Aextern Hash_table_t* hashalloc(Hash_table_t*, ...);
4495N/Aextern void hashdone(Hash_position_t*);
4495N/Aextern void hashdump(Hash_table_t*, int);
4495N/Aextern Hash_table_t* hashfree(Hash_table_t*);
4495N/Aextern Hash_bucket_t* hashlast(Hash_table_t*);
4495N/Aextern char* hashlook(Hash_table_t*, const char*, long, const char*);
4495N/Aextern Hash_bucket_t* hashnext(Hash_position_t*);
4495N/Aextern Hash_position_t* hashscan(Hash_table_t*, int);
4495N/Aextern void hashsize(Hash_table_t*, int);
4495N/Aextern Hash_table_t* hashview(Hash_table_t*, Hash_table_t*);
4495N/Aextern int hashwalk(Hash_table_t*, int, int (*)(const char*, char*, void*), void*);
4495N/A
4495N/A#undef extern
4495N/A
4495N/A#endif
4495N/A