--- parser3/src/include/pa_pool.h	2001/03/19 16:44:00	1.35
+++ parser3/src/include/pa_pool.h	2001/09/15 11:48:41	1.53
@@ -1,15 +1,17 @@
 /** @file
-	Parser
+	Parser: pool class decl.
+
 	Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
+
 	Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
 
-	$Id: pa_pool.h,v 1.35 2001/03/19 16:44:00 paf Exp $
+	$Id: pa_pool.h,v 1.53 2001/09/15 11:48:41 parser Exp $
 */
 
 #ifndef PA_POOL_H
 #define PA_POOL_H
 
-#include <stddef.h>
+#include "pa_config_includes.h"
 
 class Exception;
 class Temp_exception;
@@ -20,31 +22,50 @@ class Temp_exception;
 
 	Also holds Exception object, which can be temporary set using 
 	Temp_exception auto-object.
+
+	@see Pooled
 */
 
 class Pool {
 	friend Temp_exception;
 public:
 
-	Pool() : fexception(0) {}
-	~Pool() {}
+	Pool(void *astorage) : fstorage(astorage), fcontext(0), ftag(0), fexception(0) {}
 
-	/// current exception object of the pool
-	Exception& exception() const { return *fexception; }
+	void set_context(void *acontext) { fcontext=acontext; }
+	void *context() { return fcontext; }
+
+	void set_tag(void *atag) { ftag=atag; }
+	void *tag() { return ftag; }
 
 	/// allocates some bytes on pool
-	void *malloc(size_t size) {
-		return check(real_malloc(size), size);
+	void *malloc(size_t size/*, int place=0*/) {
+		return check(real_malloc(size/*, place*/), size);
 	}
 	/// allocates some bytes clearing them with zeros
 	void *calloc(size_t size) {
 		return check(real_calloc(size), size);
 	}
 
-private: // implementation defined
+	/// registers a routine to clean up non-pooled allocations
+	void register_cleanup(void (*cleanup) (void *), void *data);
+
+	/// current exception object of the pool
+	Exception& exception() const { return *fexception; }
+
+private:
+
+	void *fstorage;
+	void *fcontext;
+	void *ftag;
 
-    void *real_malloc(size_t size);
+private: 
+	
+	//{
+	/// @name implementation defined
+    void *real_malloc(size_t size/*, int place*/);
     void *real_calloc(size_t size);
+	//}
 
 private: 
 
@@ -63,7 +84,7 @@ private:
 
 private: // exception handling
 
-	// exception replacement mechanism is 'protected' from direct usage
+	// exception replacement mechanism is 'private'zed from direct usage
 	// Temp_exception object enforces paired set/restore
 	Exception *set_exception(Exception *e){
 		Exception *r=fexception;
@@ -89,28 +110,40 @@ private: //disabled
 	Base for all classes that are allocated in 'pools'.
 
 	Holds Pool object. Contains useful wrappers to it's methods.
+
+	@see NEW, Temp_exception
 */
 class Pooled {
 	// the pool i'm allocated on
-	Pool& fpool;
+	Pool *fpool;
 public:
-	
+
+	/// the Pooled-sole: Pooled instances can be allocated in Pool rather then on heap
 	static void *operator new(size_t size, Pool& apool) { 
-		return apool.malloc(size);
+		return apool.malloc(size/*, 1*/);
 	}
 
-	Pooled(Pool& apool) : fpool(apool) {
-	}
+	Pooled(Pool& apool) : fpool(&apool) {}
 
 	/// my pool
-	Pool& pool() const { return fpool; }
+	Pool& pool() const { return *fpool; }
+
+	/** used for moving objects from one pool to another. 
+		in between object can have no pool and can not be used
+		@see SQL_Driver_manager
+	*/
+	void set_pool(Pool *apool) { fpool=apool; }
 
 	/// useful wrapper around pool
-	void *malloc(size_t size) const { return fpool.malloc(size); }
+	void *malloc(size_t size) const { return fpool->malloc(size); }
+	/// useful wrapper around pool
+	void *calloc(size_t size) const { return fpool->calloc(size); }
 	/// useful wrapper around pool
-	void *calloc(size_t size) const { return fpool.calloc(size); }
+	void register_cleanup(void (*cleanup) (void *), void *data) { 
+		fpool->register_cleanup(cleanup, data);
+	}
 	/// useful wrapper around pool
-	Exception& exception() const { return fpool.exception(); }
+	Exception& exception() const { return fpool->exception(); }
 };
 /// useful macro for creating objects on current Pooled object Pooled::pool()
 #define NEW new(pool())
@@ -119,18 +152,20 @@ public:
 	Auto-object used for temporary changing Pool's exception().
 
 	Use by with these macros:
-	\code
+	@code
 		TRY { 
-			... 
+			// ... 
 			if(?) 
 				THROW(?); 
-			...;
+			// ...
 		} CATCH(e) { 
-			code, using e fields
-			e.comment() 
+			// code, using e fields
+			// e.comment() 
 		}
 		END_CATCH
-	\endcode
+	@endcode
+
+	@see TRY, THROW
 */
 class Temp_exception {
 	Pool& fpool;
@@ -171,8 +206,6 @@ public:
 #define PTHROW XTHROW(pool.exception())
 #define PCATCH(e) XCATCH(e)
 #define PEND_CATCH XEND_CATCH 
-
-#define RTHROW XTHROW(r.pool().exception())
 //@}
 
 #endif