Return to pa_exception.h CVS log

Up to [parser3project] / parser3 / src / include

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

1.10      paf         1: /** @file
1.11      paf         2:        Parser: exception decls.
                      3: 
1.76    ! moko        4:        Copyright (c) 2001-2026 Art. Lebedev Studio (https://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.76    ! moko       11: #define IDENT_PA_EXCEPTION_H "$Id: pa_exception.h,v 1.75 2024/12/11 03:22:23 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";
1.73      moko       21: const char* const FILE_NAME_MUST_BE_STRING_OR_FILE = "file name must be string or file";
1.72      moko       22: const char* const FILE_NAME_MUST_BE_NE_STRING = "file name must be not empty string";
1.48      misha      23: const char* const VALUE_MUST_BE_STRING = "value must be string";
1.49      misha      24: const char* const PARAMETER_MUST_BE_STRING = "parameter must be string";
1.50      misha      25: const char* const COLUMN_NAME_MUST_BE_STRING = "column name must be string";
1.48      misha      26: 
1.60      misha      27: const char* const FILE_NAME_MUST_BE_SPECIFIED = "file name must be specified";
1.51      misha      28: const char* const PARAM_MUST_NOT_BE_CODE = "param must not be code";
1.59      misha      29: const char* const PARAM_MUST_BE_HASH = "param must be hash";
1.74      moko       30: const char* const MODE_MUST_BE_STRING = "mode must be string";
1.55      misha      31: const char* const OPTIONS_MUST_NOT_BE_CODE = "options must not be code";
1.48      misha      32: 
1.57      misha      33: const char* const CALLED_WITH_INVALID_OPTION = "called with invalid option";
1.56      misha      34: 
1.39      paf        35: // includes
1.14      parser     36: 
1.39      paf        37: #include "pa_memory.h"
                     38: 
                     39: // forwards
                     40: 
                     41: class String;
1.14      parser     42: 
1.22      paf        43: // defines
                     44: 
1.1       paf        45: class Exception {
                     46: public:
                     47: 
1.19      paf        48:        Exception();
1.67      moko       49:        Exception(const char* atype, const String* aproblem_source, const char* comment_fmt, ...);
1.22      paf        50:        Exception(const Exception& src);
1.67      moko       51: 
1.44      paf        52:        operator bool() { return ftype || fproblem_source || fcomment; }
1.22      paf        53:        Exception& operator =(const Exception& src);
1.1       paf        54: 
1.10      paf        55:        /// extracts exception type
1.67      moko       56:        const char* type(bool can_be_empty=false) const {
                     57:                return can_be_empty || ftype ? ftype : "<no type>";
1.35      paf        58:        }
1.67      moko       59: 
1.10      paf        60:        /// extracts exception problem_source
1.39      paf        61:        const String* problem_source() const;
1.67      moko       62: 
1.10      paf        63:        /// extracts exception comment
1.67      moko       64:        const char* comment(bool can_be_empty=false) const {
                     65:                const char* result=fcomment && *fcomment ? fcomment : 0;
                     66:                return can_be_empty || result ? result : "<no comment>";
                     67:        }
                     68: 
                     69:        // modifies exception to fine-tune error reporting
                     70:        void set_source(const String* aproblem_source) {
                     71:                if(!problem_source())
                     72:                        fproblem_source=aproblem_source;
                     73:        }
                     74: 
                     75:        void add_comment(const char* acomment);
                     76: 
                     77: #define ALTER_EXCEPTION_SOURCE(code, source)   \
                     78:        try {                                   \
                     79:                code;                           \
                     80:        } catch (Exception& e) {                \
                     81:                e.set_source(source);           \
                     82:                rethrow;                        \
                     83:        }
                     84: 
                     85: #define ALTER_EXCEPTION_COMMENT(code, comment) \
                     86:        try {                                   \
                     87:                code;                           \
                     88:        } catch (Exception& e) {                \
                     89:                e.add_comment(comment);         \
                     90:                rethrow;                        \
1.35      paf        91:        }
1.1       paf        92: 
1.40      paf        93: protected:
1.1       paf        94: 
1.39      paf        95:        const char* ftype;
                     96:        const String* fproblem_source;
1.64      moko       97:        const char* fcomment;
1.15      parser     98: 
1.1       paf        99: };
                    100: 
                    101: #endif