Return to pa_exception.h CVS log

Up to [parser3project] / parser3 / src / include

Annotation of parser3/src/include/pa_exception.h, revision 1.71

1.10      paf         1: /** @file
1.11      paf         2:        Parser: exception decls.
                      3: 
1.70      moko        4:        Copyright (c) 2001-2024 Art. Lebedev Studio (http://www.artlebedev.com)
1.69      moko        5:        Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
1.1       paf         6: */
                      7: 
                      8: #ifndef PA_EXCEPTION_H
                      9: #define PA_EXCEPTION_H
1.36      paf        10: 
1.71    ! moko       11: #define IDENT_PA_EXCEPTION_H "$Id: pa_exception.h,v 1.70 2024/11/04 03:53:25 moko Exp $"
1.46      misha      12: 
1.47      misha      13: const char* const PARSER_RUNTIME = "parser.runtime";
1.52      misha      14: const char* const IMAGE_FORMAT = "image.format";
1.53      misha      15: const char* const PCRE_EXCEPTION_TYPE = "pcre.execute";
1.54      misha      16: const char* const DATE_RANGE_EXCEPTION_TYPE = "date.range";
1.61      misha      17: const char* const BASE64_FORMAT = "base64.format";
1.1       paf        18: 
1.48      misha      19: const char* const NAME_MUST_BE_STRING = "name must be string";
                     20: const char* const FILE_NAME_MUST_BE_STRING = "file name must be string";
                     21: const char* const VALUE_MUST_BE_STRING = "value must be string";
1.49      misha      22: const char* const PARAMETER_MUST_BE_STRING = "parameter must be string";
1.50      misha      23: const char* const COLUMN_NAME_MUST_BE_STRING = "column name must be string";
1.48      misha      24: 
1.60      misha      25: const char* const FILE_NAME_MUST_BE_SPECIFIED = "file name must be specified";
1.51      misha      26: const char* const FIRST_ARG_MUST_NOT_BE_CODE = "first argument must not be code";
                     27: const char* const PARAM_MUST_NOT_BE_CODE = "param must not be code";
1.59      misha      28: const char* const PARAM_MUST_BE_HASH = "param must be hash";
1.51      misha      29: const char* const MODE_MUST_NOT_BE_CODE = "mode must not be code";
1.55      misha      30: const char* const OPTIONS_MUST_NOT_BE_CODE = "options must not be code";
1.48      misha      31: 
1.57      misha      32: const char* const CALLED_WITH_INVALID_OPTION = "called with invalid option";
1.56      misha      33: 
1.39      paf        34: // includes
1.14      parser     35: 
1.39      paf        36: #include "pa_memory.h"
                     37: 
                     38: // forwards
                     39: 
                     40: class String;
1.14      parser     41: 
1.22      paf        42: // defines
                     43: 
1.1       paf        44: class Exception {
                     45: public:
                     46: 
1.19      paf        47:        Exception();
1.67      moko       48:        Exception(const char* atype, const String* aproblem_source, const char* comment_fmt, ...);
1.22      paf        49:        Exception(const Exception& src);
1.67      moko       50: 
1.44      paf        51:        operator bool() { return ftype || fproblem_source || fcomment; }
1.22      paf        52:        Exception& operator =(const Exception& src);
1.1       paf        53: 
1.10      paf        54:        /// extracts exception type
1.67      moko       55:        const char* type(bool can_be_empty=false) const {
                     56:                return can_be_empty || ftype ? ftype : "<no type>";
1.35      paf        57:        }
1.67      moko       58: 
1.10      paf        59:        /// extracts exception problem_source
1.39      paf        60:        const String* problem_source() const;
1.67      moko       61: 
1.10      paf        62:        /// extracts exception comment
1.67      moko       63:        const char* comment(bool can_be_empty=false) const {
                     64:                const char* result=fcomment && *fcomment ? fcomment : 0;
                     65:                return can_be_empty || result ? result : "<no comment>";
                     66:        }
                     67: 
                     68:        // modifies exception to fine-tune error reporting
                     69:        void set_source(const String* aproblem_source) {
                     70:                if(!problem_source())
                     71:                        fproblem_source=aproblem_source;
                     72:        }
                     73: 
                     74:        void add_comment(const char* acomment);
                     75: 
                     76: #define ALTER_EXCEPTION_SOURCE(code, source)   \
                     77:        try {                                   \
                     78:                code;                           \
                     79:        } catch (Exception& e) {                \
                     80:                e.set_source(source);           \
                     81:                rethrow;                        \
                     82:        }
                     83: 
                     84: #define ALTER_EXCEPTION_COMMENT(code, comment) \
                     85:        try {                                   \
                     86:                code;                           \
                     87:        } catch (Exception& e) {                \
                     88:                e.add_comment(comment);         \
                     89:                rethrow;                        \
1.35      paf        90:        }
1.1       paf        91: 
1.40      paf        92: protected:
1.1       paf        93: 
1.39      paf        94:        const char* ftype;
                     95:        const String* fproblem_source;
1.64      moko       96:        const char* fcomment;
1.15      parser     97: 
1.1       paf        98: };
                     99: 
                    100: #endif