--- parser3/src/include/pa_array.h	2001/05/17 10:22:24	1.41
+++ parser3/src/include/pa_array.h	2003/02/26 10:17:30	1.57.2.26
@@ -1,184 +1,196 @@
 /** @file
-	Parser: array class decl.
+	Parser: Array & Array_iterator classes decls.
 
-	Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
-
-	Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
-
-	$Id: pa_array.h,v 1.41 2001/05/17 10:22:24 parser Exp $
+	Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
+	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
 */
 
 #ifndef PA_ARRAY_H
 #define PA_ARRAY_H
 
-#include "pa_config_includes.h"
-#include "pa_pool.h"
-#include "pa_types.h"
-#include "pa_string.h"
-
-/**	
-	Pooled Array.
-
-	Internal structure:
-	@verbatim
-		Array               Chunk0
-		======              ========
-		head--------------->[ptr]
-		append_here-------->[ptr]
-		link_row            ........
-				.			.
-				.			[ptr]
-				...........>[link to the next chunk]
-	@endverbatim
-*/
+static const char* IDENT_ARRAY_H="$Date: 2003/02/26 10:17:30 $";
 
-class Array : public Pooled {
-public:
+// includes
 
-	/// Array item type
-	typedef void Item;
+#include "pa_memory.h"
+#include "pa_exception.h"
 
-	/*/// for_each iterator function type, const info
-	typedef void (*For_each_func_const)(Item *value, const void *info);
-	*/
-
-	/// for_each iterator function type
-	typedef void (*For_each_func)(Item *value, void *info);
-
-	/// first_that iterator function type, const info
-	typedef bool (*First_that_func_const)(Item *value, const void *info);
-
-	/// first_that iterator function type
-	typedef bool (*First_that_func)(Item *value, void *info);
-
-	enum {
-		CR_INITIAL_ROWS_DEFAULT=3, ///< default preallocated row count
-		CR_GROW_COUNT=3 ///< each time the Array chunk_is_full() array expanded()
-	};
+// forwards
 
-public:
+template<typename T> class Array_iterator;
 
-	Array(Pool& apool, int initial_rows=CR_INITIAL_ROWS_DEFAULT);
+/// Simple Array
+template<typename T> class Array: public PA_Object {
 
-	/**
-		size Array. how many items are in it. 
-		must be used with quick_get like this:
-		@code
-			int size=src.quick_size();
-			for(int i=0; i<size; i++) {
-				z=src.quick_get(i);
-			}
-		@endcode
-	*/
-	int quick_size() const { 
-		// for quick_get
-		cache_chunk_base=0;
-		cache_chunk=head;
-		return size(); 
-	}
-	/// size Array. how many items are in it
-	int size() const { return fused_rows; }
-	/// append Item to array
-	Array& operator += (Item *src);
-	/// append int value to array
-	Array& operator += (int value) { return *this+=reinterpret_cast<Item *>(value); }
+	friend class Array_iterator<T>;
 
-	/// dirty hack to allow constant items storage. I long for Array<const Item*>
-	Array& operator += (const Item *src) { return *this+=const_cast<Item *>(src); }
+protected:
 
-	/// append other Array portion to this one. starting from offset
-	Array& append_array(const Array& src, int offset=0);
+	// default expand delta size
+	int fdelta;
+
+	/// elements[growing size] here
+	T *felements;
+
+	// allocated size
+	int fallocated;
+
+	// array size
+	int fused;
 
-	/** 
-		quickly gets some item considering...
+public:
+	typedef T element_type;
+
+	Array(int initial=3, int delta=1):
+		fallocated(initial?initial:3),
+		fdelta(delta),
+		fused(0)
+	{
+		if(fallocated<=0 || fdelta<1)
+			throw Exception(0, 
+				Exception::undefined_source,
+				"Array::Array(%d, %d) too small", initial, delta);
+
+		// we can't use new(0) here[like we did in Hash] because we need to use realloc
+		// on MSVC new returns NOT pointer learned from pa_malloc, so we can't do new+realloc
+		felements=static_cast<T*>(calloc(fallocated*sizeof(T)));
+	}
+	override ~Array() {
+		// see comment in ctor
+		T *last=felements+fused;
+		for(T *current=felements; current<last; current++)
+			current->~T(); // manually invoking destructors
+
+		free(felements);
+	}
+
+	/// how many items are in Array
+	int count() const { return fused; }
+	/// append to array
+	Array& operator += (T src) {
+		if(is_full())
+			expand(fdelta);
+
+		felements[fused++]=src;
+
+		return *this;
+	}
 
-		these true:
-			- index increments from 0 to size()-1
-			- index>=0 && index<size()
-			- index>=cache_chunk_base
-	*/
-	Item *quick_get(int index) const {
-		// next chunk will be with "index" row
-		if(!(index<cache_chunk_base+cache_chunk->count)) {
-			int count=cache_chunk->count;
-			cache_chunk_base+=count;
-			cache_chunk=cache_chunk->rows[count].link;
+	/// append other Array portion to this one. starting from offset
+	Array& append(const Array& src, int offset=0, int limit=0) {
+		if(offset<0) {
+			throw Exception(0, 
+				Exception::undefined_source,
+				"Array::append(offset=%d) out <0", offset);
+			//return Nothing; // never
+		}
+		// fix limit
+		{
+			int m=src.count()-offset;
+			if(!m || limit<0)
+				return *this;
+			if(!limit || limit>m)
+				limit=m;
 		}
+
+		int delta=limit-(fallocated-fused);
+		if(delta>0)
+			expand(delta);
+
+		T* from=&src.felements[offset];
+		T* to=&felements[fused];
+		T* from_end=from+limit;
+		while(from<from_end)
+			*to++=*from++;
 		
-		return cache_chunk->rows[index-cache_chunk_base].item;
+		fused+=limit;
+		return *this;
 	}
 
-	Item *get(int index) const;
-	int get_int(int index) const { return reinterpret_cast<int>(get(index)); }
+	/// get index-element
+	T& get(int index) const {
+		if(!(index>=0 && index<count())) {
+			throw Exception(0, 
+				Exception::undefined_source,
+				"Array::get(%d) out of range [0..%d]", index, count()-1);
+			return felements[0]; // never
+		}
 
-	void put(int index, Item *item);
-	/// convinient way to get strings from Array. I long for Array<const String *>
-	const String *get_string(int index) const { 
-		return const_cast<const String *>(static_cast<String *>(get(index))); 
+		return felements[index];
 	}
-	const String *quick_get_string(int index) const { 
-		return const_cast<const String *>(static_cast<String *>(quick_get(index))); 
+
+	T& operator [](int index) const { return get(index); }
+
+	/// put index-element
+	void put(int index, T& element) {
+		if(!(index>=0 && index<count())) {
+			throw Exception(0, 
+				Exception::undefined_source, 
+				"Array::put(%d) out of range [0..%d]", index, count()-1);
+			return; // never
+		}
+		felements[index]=element;
 	}
 
-	/*/// iterate over all elements, const info
-	void for_each(For_each_func_const func, const void *info=0) const;
-	/*/
 
 	/// iterate over all elements
-	void for_each(For_each_func func, void *info=0) const;
+	template<typename I> void for_each(void (*callback)(T, I), I info) const {
+		T *last=felements+fused;
+		for(T *current=felements; current<last; current++)
+			callback(*current, info);
+	}
 
-	/// iterate over all elements until condition, const info
-	void* first_that(First_that_func_const func, const void *info=0) const;
+	/// iterate over all elements until condition becomes true, return that element
+	template<typename I> T first_that(bool (*callback)(T, I), I info) const {
+		T *last=felements+fused;
+		for(T *current=felements; current<last; current++)
+			if(callback(*current, info))
+				return *current;
+
+		return T(0);
+	}
 
-	/// iterate over all elements until condition
-	void* first_that(First_that_func func, void *info=0) const;
+protected:
 
-private:
-
-	/// several record elements
-	struct Chunk {
-		int count;  ///< the number of rows in chunk
-		/// item or a link to next chunk union
-		union Row {
-			Item *item;
-			Chunk *link;  ///< link to the next chunk in chain
-		} rows[1];
-		// next rows are here
-	}
-		*head;  ///< the head chunk of the chunk chain
-
-	/** last allocated chunk
-		helps appending Arrays
-	*/
-	Chunk *tail;
-
-	/// next append would write to this record
-	Chunk::Row *append_here;
-	
-	/**	the address of place where lies address 
-		of the link to the next chunk to allocate
-	*/
-	Chunk::Row *link_row;
+	bool is_full() {
+		return fused == fallocated;
+	}
+	void expand(int delta) {
+		felements = (T *)realloc(felements, (fallocated+delta)*sizeof(T));
+		memset(&felements[fallocated], 0, delta*sizeof(T));
+		fallocated+=delta;
+	}
 
-private:
+private: //disabled
 
-	// array size
-	int fused_rows;
+	Array& operator = (const Array&) { return *this; }
+};
+
+
+/// handy array iterator
+template<typename T> class Array_iterator {
+
+	Array<T>& farray;
+	T *fcurrent;
+	T *flast;
+
+public:
 
-	mutable int cache_chunk_base;
-	mutable Chunk *cache_chunk;
-	
-private:
+	Array_iterator(Array<T>& aarray): farray(aarray) {
+		fcurrent=farray.felements;
+		flast=farray.felements+farray.count();
+	}
 
-	bool chunk_is_full() {
-		return append_here == link_row;
+	/// there are still elements
+	bool has_next() {
+		return fcurrent<flast;
 	}
-	void expand(int chunk_rows);
 
-private: //disabled
+	/// quickly extracts next Array element
+	T& next() {
+		return *(fcurrent++);
+	}
 
-	//Array(Array&) { }
-	Array& operator = (const Array&) { return *this; }
 };
 
 #endif