--- parser3/src/sql/pa_sql_driver.h	2004/05/25 07:05:52	1.40
+++ parser3/src/sql/pa_sql_driver.h	2008/06/26 14:42:09	1.45
@@ -1,7 +1,7 @@
 /** @file
 	Parser: sql driver interface.
 
-	Copyright (c) 2001-2004 ArtLebedev Group (http://www.artlebedev.com)
+	Copyright (c) 2001-2005 ArtLebedev Group (http://www.artlebedev.com)
 	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
 
 
@@ -26,16 +26,26 @@
 #ifndef PA_SQL_DRIVER_H
 #define PA_SQL_DRIVER_H
 
-static const char * const IDENT_SQL_DRIVER_H="$Date: 2004/05/25 07:05:52 $";
+static const char * const IDENT_SQL_DRIVER_H="$Date: 2008/06/26 14:42:09 $";
 
 #include <sys/types.h>
 #include <setjmp.h>
 #include <stdlib.h>
+#include <limits.h>
 
-#define SQL_DRIVER_API_VERSION 0x0008
+/*
+    1..8 not logged
+	9 introducing placeholders
+	10 limit fixed (default: SQL_NO_LIMIT [ULONG_MAX]), path to document_root added
+*/
+#define SQL_DRIVER_API_VERSION 10
+//#define SQL_DRIVER_API_VERSION 9
 #define SQL_DRIVER_CREATE create /* used in driver implementation */
 #define SQL_DRIVER_CREATE_NAME "create" /* could not figure out how to # it :( */
 
+#define SQL_NO_LIMIT ULONG_MAX
+//#define SQL_NO_LIMIT 0
+
 /// fields are freed elsewhere
 class SQL_Error {
 	bool fdefined;
@@ -77,6 +87,8 @@ public:
 	virtual void *realloc(void *ptr, size_t size) =0;
 	/// $request:charset
 	virtual const char* request_charset() =0;
+	/// $request:document-root
+	virtual const char* request_document_root() =0;
 	/// transcoder. 
 	/// WARNING: can store pointers to charset names to speedup name-to-instance resolving
 	/// so do NOT pass pointers to local vars and change those vars after that
@@ -113,6 +125,15 @@ public:
 class SQL_Driver {
 public:
 
+	/// @todo can be optimized to contain type information, 
+	/// to pass IN and OUT int/double NOT in string format
+	struct Placeholder {
+		const char* name;
+		const char* value;
+		bool is_null;
+		bool were_updated;
+	};
+
 	/** allocated using our allocator,
 		@todo never freed
 	*/
@@ -144,7 +165,9 @@ public:
 	virtual const char* quote(void *connection,
 		const char* str, unsigned int length) =0;
 	virtual void query(void *connection,
-		const char* statement, unsigned long offset, unsigned long limit,
+		const char* statement, 
+		size_t placeholders_count, Placeholder* placeholders,
+		unsigned long offset, unsigned long limit,
 		SQL_Driver_query_event_handlers& handlers) =0;
 };