--- parser3/src/sql/pa_sql_driver.h	2003/07/24 11:31:24	1.35
+++ parser3/src/sql/pa_sql_driver.h	2023/09/26 20:49:10	1.53
@@ -1,8 +1,8 @@
 /** @file
 	Parser: sql driver interface.
 
-	Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
-	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
+	Copyright (c) 2001-2023 Art. Lebedev Studio (http://www.artlebedev.com)
+	Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
 
 
 	driver dynamic library must look like this:
@@ -26,16 +26,26 @@
 #ifndef PA_SQL_DRIVER_H
 #define PA_SQL_DRIVER_H
 
-static const char* IDENT_SQL_DRIVER_H="$Date: 2003/07/24 11:31:24 $";
+#define IDENT_PA_SQL_DRIVER_H "$Id: pa_sql_driver.h,v 1.53 2023/09/26 20:49:10 moko Exp $"
 
 #include <sys/types.h>
 #include <setjmp.h>
 #include <stdlib.h>
+#include <limits.h>
 
-#define SQL_DRIVER_API_VERSION 0x0007
+/*
+    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;
@@ -75,6 +85,18 @@ public:
 	virtual void *malloc_atomic(size_t size) =0;
 	/// reallocates bytes 
 	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
+	virtual void transcode(const char* src, size_t src_length,
+		const char*& dst, size_t& dst_length,
+		const char* charset_from_name,
+		const char* charset_to_name
+		) =0;
 	/// prepare throw exception
 	virtual void _throw(const SQL_Error& e) =0;
 	/// throw C++ exception from prepared
@@ -103,44 +125,39 @@ public:
 class SQL_Driver {
 public:
 
-	/** allocated using our allocator,
-		@todo never freed
-	*/
-	static void *operator new(size_t size) { 
-		void *result=::malloc(size);
-		if(!result)
-			abort();
+	/// @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;
+	};
 
-		return result;
-	}
 	/// get api version
 	virtual int api_version() =0;
 	/// initialize driver by loading sql dynamic link library
 	virtual const char* initialize(char *dlopen_file_spec) =0;
 	/**	connect to sql database using 
-		@param used_only_to_connect_url 
+		@param url_cstr
 			format is driver specific
-			WARNING: must be used only to connect, for buffer doesn't live long enough
 
 		@returns true+'connection' on success. 'error' on failure
 	*/
-	virtual void connect(char *used_only_in_connect_url_cstr, 
+	virtual void connect(char *url_cstr, 
 		SQL_Driver_services& services, void **connection) =0;
 	virtual void disconnect(void *connection) =0;
-	virtual void commit(
-		SQL_Driver_services& services, void *connection) =0;
-	virtual void rollback(
-		SQL_Driver_services& services, void *connection) =0;
+	virtual void commit(void *connection) =0;
+	virtual void rollback(void *connection) =0;
 	/// @returns true to indicate that connection still alive 
-	virtual bool ping(
-		SQL_Driver_services& services, void *connection) =0;
+	virtual bool ping(void *connection) =0;
 	/// encodes the string in 'from' to an escaped SQL string
-	virtual const char* quote(
-		SQL_Driver_services& services, void *connection,
+	virtual const char* quote(void *connection,
 		const char* str, unsigned int length) =0;
-	virtual void query(
-		SQL_Driver_services& services, void *connection,
-		const char* statement, unsigned long offset, unsigned long limit,
+	virtual void query(void *connection,
+		const char* statement, 
+		size_t placeholders_count, Placeholder* placeholders,
+		unsigned long offset, unsigned long limit,
 		SQL_Driver_query_event_handlers& handlers) =0;
 };