Diff for /parser3/src/include/pa_exception.h between versions 1.21 and 1.76

version 1.21, 2001/11/15 18:21:31 version 1.76, 2026/04/25 13:38:46
Line 1 Line 1
 /** @file  /** @file
         Parser: exception decls.          Parser: exception decls.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2026 Art. Lebedev Studio (https://www.artlebedev.com)
         Author: Alexander Petrosyan <paf@design.ru> (http://paf.design.ru)          Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
   
         $Id$  
 */  */
   
 #ifndef PA_EXCEPTION_H  #ifndef PA_EXCEPTION_H
 #define PA_EXCEPTION_H  #define PA_EXCEPTION_H
   
 #include "pa_config_includes.h"  #define IDENT_PA_EXCEPTION_H "$Id$"
 #include "pa_types.h"  
 #include "pa_string.h"  const char* const PARSER_RUNTIME = "parser.runtime";
   const char* const IMAGE_FORMAT = "image.format";
 #ifdef XML  const char* const PCRE_EXCEPTION_TYPE = "pcre.execute";
 #include <PlatformSupport/XSLException.hpp>  const char* const DATE_RANGE_EXCEPTION_TYPE = "date.range";
 #include <sax/SAXException.hpp>  const char* const BASE64_FORMAT = "base64.format";
 #include <sax/SAXParseException.hpp>  
 #include <util/XMLException.hpp>  const char* const NAME_MUST_BE_STRING = "name must be string";
 #endif  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 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_BE_STRING = "mode must be string";
   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"
   
 class Pool;  // forwards
   
   class String;
   
   // defines
   
 /// Just simple longjump mechanizm dressed in class clothes. use Temp_exception  
 class Exception {  class Exception {
 public:  public:
   
         Exception();          Exception();
         Exception(          Exception(const char* atype, const String* aproblem_source, const char* comment_fmt, ...);
                 const String *atype, const String *acode,          Exception(const Exception& src);
                 const String *aproblem_source,   
                 const char *comment_fmt, ...);          operator bool() { return ftype || fproblem_source || fcomment; }
           Exception& operator =(const Exception& src);
 #ifdef XML  
         /// converts XSL exception to parser exception  
         static void provide_source(Pool& pool, const String *source, const XSLException& e);  
         /// converts SAX exception to parser exception  
         static void provide_source(Pool& pool, const String *source, const SAXException& e);  
         /// converts SAX parse exception to parser exception  
         static void provide_source(Pool& pool, const String *source, const SAXParseException& e);  
         /// converts XML exception to parser exception  
         static void provide_source(Pool& pool, const String *source, const XMLException& e);  
         /// converts Xalan DOM exception to parser exception  
         static void provide_source(Pool& pool, const String *source, const XalanDOMException& e);  
 #endif  
   
         /// extracts exception type          /// extracts exception type
         const String *type() const { return ftype; }          const char* type(bool can_be_empty=false) const {
         /// extracts exception code                  return can_be_empty || ftype ? ftype : "<no type>";
         const String *code() const { return fcode; }          }
         /// extracts exception problem_source  
         const String *problem_source() const { return fproblem_source; }  
         /// extracts exception comment  
         const char *comment() const { return *fcomment?fcomment:0; }  
   
 private:          /// extracts exception problem_source
           const String* problem_source() const;
   
         const String *ftype, *fcode, *fproblem_source;          /// extracts exception comment
         char fcomment[MAX_STRING];          const char* comment(bool can_be_empty=false) const {
                   const char* result=fcomment && *fcomment ? fcomment : 0;
                   return can_be_empty || result ? result : "<no comment>";
           }
   
           // modifies exception to fine-tune error reporting
           void set_source(const String* aproblem_source) {
                   if(!problem_source())
                           fproblem_source=aproblem_source;
           }
   
           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 char* ftype;
           const String* fproblem_source;
           const char* fcomment;
   
 };  };
   

Removed from v.1.21  
changed lines
  Added in v.1.76


E-mail: