--- parser3/src/include/pa_exception.h	2003/01/27 17:17:06	1.38.2.6
+++ parser3/src/include/pa_exception.h	2024/12/11 00:37:04	1.73
@@ -1,78 +1,102 @@
 /** @file
 	Parser: exception decls.
 
-	Copyright (c) 2001, 2003 ArtLebedev Group (http://www.artlebedev.com)
-	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
+	Copyright (c) 2001-2024 Art. Lebedev Studio (http://www.artlebedev.com)
+	Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
 */
 
 #ifndef PA_EXCEPTION_H
 #define PA_EXCEPTION_H
 
-static const char* IDENT_EXCEPTION_H="$Date: 2003/01/27 17:17:06 $";
+#define IDENT_PA_EXCEPTION_H "$Id: pa_exception.h,v 1.73 2024/12/11 00:37:04 moko Exp $"
 
-//#include "pa_types.h"
-#include "pa_pool.h"
+const char* const PARSER_RUNTIME = "parser.runtime";
+const char* const IMAGE_FORMAT = "image.format";
+const char* const PCRE_EXCEPTION_TYPE = "pcre.execute";
+const char* const DATE_RANGE_EXCEPTION_TYPE = "date.range";
+const char* const BASE64_FORMAT = "base64.format";
+
+const char* const NAME_MUST_BE_STRING = "name must be string";
+const char* const FILE_NAME_MUST_BE_STRING = "file name must be string";
+const char* const FILE_NAME_MUST_BE_STRING_OR_FILE = "file name must be string or file";
+const char* const FILE_NAME_MUST_BE_NE_STRING = "file name must be not empty string";
+const char* const VALUE_MUST_BE_STRING = "value must be string";
+const char* const PARAMETER_MUST_BE_STRING = "parameter must be string";
+const char* const COLUMN_NAME_MUST_BE_STRING = "column name must be string";
+
+const char* const FILE_NAME_MUST_BE_SPECIFIED = "file name must be specified";
+const char* const FIRST_ARG_MUST_NOT_BE_CODE = "first argument must not be code";
+const char* const PARAM_MUST_NOT_BE_CODE = "param must not be code";
+const char* const PARAM_MUST_BE_HASH = "param must be hash";
+const char* const MODE_MUST_NOT_BE_CODE = "mode must not be code";
+const char* const OPTIONS_MUST_NOT_BE_CODE = "options must not be code";
+
+const char* const CALLED_WITH_INVALID_OPTION = "called with invalid option";
+
+// includes
+
+#include "pa_memory.h"
 
 // forwards
 
 class String;
-typedef object_ptr<const String> ConstStringPtr;
 
 // defines
 
 class Exception {
 public:
 
-	static const ConstStringPtr undefined_source;
-
 	Exception();
-	Exception(
-		const char *atype,
-		ConstStringPtr aproblem_source, 
-		const char *comment_fmt, ...);
-	Exception(const Exception& src):
-		ftype(src.ftype),
-		fproblem_source(src.fproblem_source),
-		fcomment(src.fcomment) {
-	}
-	Exception& operator =(const Exception& src) {
-		ftype=src.ftype;
-		fproblem_source=src.fproblem_source;
-		fcomment=src.fcomment;
-		return *this;
-	}
+	Exception(const char* atype, const String* aproblem_source, const char* comment_fmt, ...);
+	Exception(const Exception& src);
 
-#ifdef XML
-	Exception(
-		ConstStringPtr aproblem_source, 
-		GdomeException& exc);
-#endif
+	operator bool() { return ftype || fproblem_source || fcomment; }
+	Exception& operator =(const Exception& src);
 
 	/// extracts exception type
-	const char *type(bool can_be_empty=false) const { 
-		if(can_be_empty)
-			return ftype; 
-		else
-			return ftype?ftype:"<no type>";
+	const char* type(bool can_be_empty=false) const {
+		return can_be_empty || ftype ? ftype : "<no type>";
 	}
+
 	/// extracts exception problem_source
-	ConstStringPtr problem_source() const;	/// extracts exception comment
-	const char *comment(bool can_be_empty=false) const { 
-		const char *result=fcomment.get()!=0 && *fcomment.get()?fcomment.get():0;
-		if(can_be_empty)
-			return result; 
-		else
-			return result?result:"<no comment>";
+	const String* problem_source() const;
+
+	/// extracts exception comment
+	const char* comment(bool can_be_empty=false) const {
+		const char* result=fcomment && *fcomment ? fcomment : 0;
+		return can_be_empty || result ? result : "<no comment>";
 	}
 
-private:
+	// modifies exception to fine-tune error reporting
+	void set_source(const String* aproblem_source) {
+		if(!problem_source())
+			fproblem_source=aproblem_source;
+	}
 
-	const char *ftype;
-	ConstStringPtr fproblem_source;
-	CharPtr fcomment;
+	void add_comment(const char* acomment);
 
-};
+#define ALTER_EXCEPTION_SOURCE(code, source)	\
+	try {					\
+		code;				\
+	} catch (Exception& e) {		\
+		e.set_source(source);		\
+		rethrow;			\
+	}
+
+#define ALTER_EXCEPTION_COMMENT(code, comment)	\
+	try {					\
+		code;				\
+	} catch (Exception& e) {		\
+		e.add_comment(comment);		\
+		rethrow;			\
+	}
+
+protected:
 
-const ConstStringPtr Exception::undefined_source(0);
+	const char* ftype;
+	const String* fproblem_source;
+	const char* fcomment;
+
+};
 
 #endif