--- parser3/src/include/pa_hash.h	2001/01/27 12:04:53	1.2
+++ parser3/src/include/pa_hash.h	2009/04/17 13:13:09	1.71
@@ -1,88 +1,514 @@
-/*
-  $Id: pa_hash.h,v 1.2 2001/01/27 12:04:53 paf Exp $
-*/
+/** @file
+	Parser: hash class decl.
 
-/*
+	Copyright (c) 2001-2005 ArtLebedev Group (http://www.artlebedev.com)
 
+	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
+*/
 
+/*
+	The prime numbers used from zend_hash.c,
+	the part of Zend scripting engine library,
+	Copyrighted (C) 1999-2000    Zend Technologies Ltd.
+	http://www.zend.com/license/0_92.txt
+	For more information about Zend please visit http://www.zend.com/
 */
 
 #ifndef PA_HASH_H
 #define PA_HASH_H
 
-#include <stddef.h>
+static const char * const IDENT_HASH_H="$Date: 2009/04/17 13:13:09 $";
 
+#include "pa_memory.h"
 #include "pa_types.h"
-#include "pa_string.h"
 
-class Pool;
+const int HASH_ALLOCATES_COUNT=29;
 
-typedef String Key;
-typedef void Value;
+/** Zend comment: Generated on an Octa-ALPHA 300MHz CPU & 2.5GB RAM monster 
 
-class Hash {
+	paf: HPUX ld could not handle static member: unsatisfied symbols
+*/
+static uint Hash_allocates[HASH_ALLOCATES_COUNT]={
+	5, 11, 19, 53, 107, 223, 463, 983, 1979, 3907, 7963, 
+	16229, 32531, 65407, 130987, 262237, 524521, 1048793, 
+	2097397, 4194103, 8388857, 16777447, 33554201, 67108961, 
+	134217487, 268435697, 536870683, 1073741621, 2147483399};
+
+/// useful generic hash function
+inline void generic_hash_code(uint& result, char c) {
+	result=(result<<4)+c;
+	if(uint g=(result&0xF0000000)) {
+		result=result^(g>>24);
+		result=result^g;
+	}
+}
+/// useful generic hash function
+inline void generic_hash_code(uint& result, const char* s) {
+	while(char c=*s++) {
+		result=(result<<4)+c;
+		if(uint g=(result&0xF0000000)) {
+			result=result^(g>>24);
+			result=result^g;
+		}
+	}
+}
+
+/// useful generic hash function
+inline void generic_hash_code(uint& result, const char* buf, size_t size) {
+	const char* end=buf+size;
+	while(buf<end) {
+		result=(result<<4)+*buf++;
+		if(uint g=(result&0xF0000000)) {
+			result=result^(g>>24);
+			result=result^g;
+		}
+	}
+}
+
+/// simple hash code of int. used by EXIF mapping
+inline uint hash_code(int self) {
+	uint result=0;
+	generic_hash_code(result, (const char*)&self, sizeof(self));
+	return result;
+}
+
+/** 
+	Simple hash.
+
+	Automatically rehashed when almost is_full.
+	Contains no 0 values. 
+		get returning 0 means there were no such.
+		"put value 0" means "remove"
+*/
+template<typename K, typename V> class Hash: public PA_Object {
 public:
 
+	typedef K key_type;
+	typedef V value_type;
+
+	Hash() { 
+		allocated=Hash_allocates[allocates_index=0];
+		threshold=allocated*THRESHOLD_PERCENT/100;
+		fpairs_count=fused_refs=0;
+		refs=new(UseGC) Pair*[allocated];
+	}
+
+	Hash(const Hash& source) {
+		allocates_index=source.allocates_index;
+		allocated=source.allocated;
+		threshold=source.threshold;
+		fused_refs=source.fused_refs;
+		fpairs_count=source.fpairs_count;
+		refs=new(UseGC) Pair*[allocated];
+
+		// clone & rehash
+		Pair **old_ref=source.refs;
+		for(int index=0; index<allocated; index++)
+			for(Pair *pair=*old_ref++; pair; ) {
+				Pair *next=pair->link;
+
+				Pair **new_ref=&refs[index];
+				*new_ref=new Pair(pair->code, pair->key, pair->value, *new_ref);
+
+				pair=next;
+			}
+	}
+
+	~Hash() {
+		delete[] refs;
+	}
+
+	/// put a [value] under the [key] @returns existed or not
+	bool put(K key, V value) {
+		if(!value) {
+			remove(key);
+			return false;
+		}
+		if(is_full()) 
+			expand();
+
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		Pair **ref=&refs[index];
+		for(Pair *pair=*ref; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key) {
+				// found a pair with the same key
+				pair->value=value;
+				return true;
+			}
+		
+		// proper pair not found -- create&link_in new pair
+		if(!*ref) // root cell were fused_refs?
+			fused_refs++; // not, we'll use it and record the fact
+		*ref=new Pair(code, key, value, *ref);
+		fpairs_count++;
+		return false;
+	}
+
+	/// put a [value] under the [key] @returns existed or not
+	template<typename R, typename F, typename I> R replace_maybe_append(K key, V value, F prevent, I info) {
+		if(!value) {
+			// they can come here from somewhere (true with maybe_replace_maybe_append, keeping parallel)
+			remove(key);
+			// this has nothing to do with properties, doing no special property handling here
+			return 0; 
+		}
+
+		if(is_full()) 
+			expand();
+
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		Pair **ref=&refs[index];
+		for(Pair *pair=*ref; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key) {
+				// found a pair with the same key
+				pair->value=value;
+				return reinterpret_cast<R>(1);
+			}
+		
+		// proper pair not found 
+		// prevent-function intercepted append?
+		if(R result=prevent(value, info))
+			return result;
+		
+		//create&link_in new pair
+		if(!*ref) // root cell were fused_refs?
+			fused_refs++; // not, we'll use it and record the fact
+		*ref=new Pair(code, key, value, *ref);
+		fpairs_count++;
+		return 0;
+	}
+
+	/// put a [value] under the [key] @returns existed or not
+	template<typename R, typename F1, typename F2, typename I> 
+		R maybe_replace_maybe_append(K key, V value, F1 prevent_replace, F2 prevent_append, I info) 
+	{
+		if(!value) {
+			// they can come here from Temp_value_element::dctor to restore some empty value
+			remove(key);
+			// this has nothing to do with properties, doing no special property handling here
+			return 0; 
+		}
+
+		if(is_full()) 
+			expand();
+
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		Pair **ref=&refs[index];
+		for(Pair *pair=*ref; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key) {
+				// found a pair with the same key
+
+				// prevent-function intercepted replace?
+				if(R result=prevent_replace(pair->value, info))
+					return result;
+				
+				pair->value=value;
+				return reinterpret_cast<R>(1);
+			}
+		
+		// proper pair not found 
+		// prevent-function intercepted append?
+		if(R result=prevent_append(value, info))
+			return result;
+		
+		//create&link_in new pair
+		if(!*ref) // root cell were fused_refs?
+			fused_refs++; // not, we'll use it and record the fact
+		*ref=new Pair(code, key, value, *ref);
+		fpairs_count++;
+		return 0;
+	}
+
+	/// put a [value] under the [key] @returns existed or not
+	template<typename R, typename F1, typename I> 
+		R maybe_replace_never_append(K key, V value, F1 prevent_replace, I info) 
+	{
+		if(!value) {
+			// they can come here from somewhere (true with maybe_replace_maybe_append, keeping parallel)
+			remove(key);
+			// this has nothing to do with properties, doing no special property handling here
+			return 0; 
+		}
+
+		if(is_full()) 
+			expand();
+
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		Pair **ref=&refs[index];
+		for(Pair *pair=*ref; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key) {
+				// found a pair with the same key
+
+				// prevent-function intercepted replace?
+				if(R result=prevent_replace(pair->value, info))
+					return result;
+				
+				pair->value=value;
+				return reinterpret_cast<R>(1);
+			}
+		
+		return 0;
+	}
+
+	/// remove the [key] @returns existed or not
+	bool remove(K key) {
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		for(Pair **ref=&refs[index]; *ref; ref=&(*ref)->link)
+			if((*ref)->code==code && (*ref)->key==key) {
+				// found a pair with the same key
+				Pair *next=(*ref)->link;
+				delete *ref;
+				*ref=next;
+				--fpairs_count;
+				return true;
+			}
+
+		return false;
+	}
+
+	/// return true if key exists
+	bool contains(K key){
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		for(Pair *pair=refs[index]; pair; pair=pair->link){
+			if(pair->code==code && pair->key==key)
+				return true;
+		}
+
+		return false;
+	}
+
+	/// get associated [value] by the [key]
+	V get(K key) const {
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		for(Pair *pair=refs[index]; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key)
+				return pair->value;
+		
+		return V(0);
+	}
+
+	/// get associated [value] by the [key] + [code] (faster)
+	V get_by_hash_code(uint code, K key) const {
+		uint index=code%allocated;
+		for(Pair *pair=refs[index]; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key)
+				return pair->value;
+		
+		return V(0);
+	}
+ 
+	/// put a [value] under the [key] if that [key] existed @returns existed or not
+	bool put_replaced(K key, V value) {
+		if(!value) {
+			remove(key);
+			return false;
+		}
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		for(Pair *pair=refs[index]; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key) {
+				// found a pair with the same key, replacing
+				pair->value=value;
+				return true;
+			}
+
+		// proper pair not found 
+		return false;
+	}
+
+	/// put a [value] under the [key] if that [key] existed @returns existed or not
+	template<typename R, typename F> R maybe_put_replaced(K key, V value, F prevent) {
+		if(!value) {
+			// they can come here from Temp_value_element::dctor to restore some empty value
+			remove(key);
+			// this has nothing to do with properties, doing no special property handling here
+			return 0; 
+		}
+
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		for(Pair *pair=refs[index]; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key) {
+				// found a pair with the same key, replacing
+				// prevent-function intercepted put?
+				if(R result=prevent(pair->value))
+					return result;
+				
+				pair->value=value;
+				return reinterpret_cast<R>(1);
+			}
+
+		// proper pair not found 
+		return 0;
+	}
+
+	/// put a [value] under the [key] if that [key] NOT existed @returns existed or not
+	bool put_dont_replace(K key, V value) {
+		if(!value) {
+			remove(key);
+			return false;
+		}
+		if(is_full()) 
+			expand();
+
+		uint code=hash_code(key);
+		uint index=code%allocated;
+		Pair **ref=&refs[index];
+		for(Pair *pair=*ref; pair; pair=pair->link)
+			if(pair->code==code && pair->key==key) {
+				// found a pair with the same key, NOT replacing
+				return true;
+			}
+
+		// proper pair not found -- create&link_in new pair
+		if(!*ref) // root cell were fused_refs?
+			fused_refs++; // not, we'll use it and record the fact
+		*ref=new Pair(code, key, value, *ref);
+		fpairs_count++;
+		return false;
+	}
+
+	/** put all 'src' values if NO with same key existed
+		@todo optimize this.allocated==src.allocated case
+	*/
+	void merge_dont_replace(const Hash& src) {
+		for(int i=0; i<src.allocated; i++)
+			for(Pair *pair=src.refs[i]; pair; pair=pair->link)
+				put_dont_replace(pair->key, pair->value);
+	}
+
+	/// number of elements in hash
+	int count() const { return fpairs_count; }
+
+	/// iterate over all pairs
+	template<typename I> void for_each(void callback(K, V, I), I info) const {
+		Pair **ref=refs;
+		for(int index=0; index<allocated; index++)
+			for(Pair *pair=*ref++; pair; pair=pair->link)
+				callback(pair->key, pair->value, info);
+	}
+
+	/// iterate over all pairs
+	template<typename I> void for_each_ref(void callback(K, V&, I), I info) const {
+		Pair **ref=refs;
+		for(int index=0; index<allocated; index++)
+			for(Pair *pair=*ref++; pair; pair=pair->link)
+				callback(pair->key, pair->value, info);
+	}
+
+	/// iterate over all pairs until condition becomes true, return that element
+	template<typename I> V first_that(bool callback(K, V, I), I info) const {
+		Pair **ref=refs;
+		for(int index=0; index<allocated; index++)
+			for(Pair *pair=*ref++; pair; pair=pair->link)
+				if(callback(pair->key, pair->value, info))
+					return pair->value;
+		
+		return V(0);
+	}
+
+	/// remove all elements
+	void clear() {
+		memset(refs, 0, sizeof(*refs)*allocated);
+		fpairs_count=fused_refs=0;	
+	}
+
 private:
-	friend Pool;
 
-	// expand when there would be used this %% of size
+	/// expand when these %% of allocated exausted
 	enum {
 		THRESHOLD_PERCENT=75
 	};
 
-	// the pool I'm allocated on
-	Pool *pool;
-
-	// the index of size in sizes
-	int size_index;
+	/// the index of [allocated] in [Hash_allocates]
+	int allocates_index;
 
-	// possible sizes. prime numbers
-	static uint sizes[];
-	static int sizes_count;
+	/// number of allocated pairs
+	int allocated;
 
-	// number of allocated pairs
-	int size;
-
-	// helper: expanding when used == threshold
+	/// helper: expanding when fused_refs == threshold
 	int threshold;
 
-	// used pairs
-	int used;
+	/// used pairs
+	int fused_refs;
 
-	// main storage
-	class Pair {
-		friend Hash;
+	/// stored pairs total (including those by links)
+	int fpairs_count;
 
+	/// pair storage
+	class Pair: public PA_Allocated {
+	public:
 		uint code;
-		Key key;
-		Value *value;
+		K key;
+		V value;
 		Pair *link;
 		
-		void *operator new(size_t size, Pool *apool);
-
-		Pair(uint acode, Key& akey, Value *avalue, Pair *alink) :
+		Pair(uint acode, K akey, V avalue, Pair *alink) :
 			code(acode),
 			key(akey),
 			value(avalue),
 			link(alink) {}
 	} **refs;
 
-	// new&constructors made private to enforce factory manufacturing at pool
-	void *operator new(size_t size, Pool *apool);
+	/// filled to threshold: needs expanding
+	bool is_full() { return fused_refs==threshold; }
+
+	/// allocate larger buffer & rehash
+	void expand() {
+		int old_allocated=allocated;
+		Pair **old_refs=refs;
+
+		allocates_index=allocates_index+1<HASH_ALLOCATES_COUNT?allocates_index+1:HASH_ALLOCATES_COUNT-1;
+		// allocated bigger refs array
+		allocated=Hash_allocates[allocates_index];
+		threshold=allocated*THRESHOLD_PERCENT/100;
+		refs=new(UseGC) Pair*[allocated];
+
+		// rehash
+		Pair **old_ref=old_refs;
+		for(int old_index=0; old_index<old_allocated; old_index++)
+			for(Pair *pair=*old_ref++; pair; ) {
+				Pair *next=pair->link;
+
+				uint new_index=pair->code%allocated;
+				Pair **new_ref=&refs[new_index];
+				pair->link=*new_ref;
+				*new_ref=pair;
 
-	Hash(Pool *apool);
+				pair=next;
+			}
 
-	bool full() {
-		return used==threshold;
+		delete[] old_refs;
 	}
-	void expand();
 
-public:
+private: //disabled
 
-	static uint generic_code(uint aresult, char *start, uint size);
-	void put(Key& key, Value *value);
-	Value* get(Key& key);
+	Hash& operator = (const Hash&) { return *this; }
+};
+
+///	Auto-object used to temporarily substituting/removing hash values
+template <typename K, typename V>
+class Temp_hash_value {
+	Hash<K, V>& fhash;
+	K fname;
+	V saved_value;
+public:
+	Temp_hash_value(Hash<K, V>& ahash, K aname, V avalue) : 
+		fhash(ahash),
+		fname(aname),
+		saved_value(ahash.get(aname)) {
+		fhash.put(aname, avalue);
+	}
+	~Temp_hash_value() { 
+		fhash.put(fname, saved_value);
+	}
 };
 
 #endif