Return to pa_exception.h CVS log

Up to [parser3project] / parser3 / src / include

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

1.10      paf         1: /** @file
1.11      paf         2:        Parser: exception decls.
                      3: 
1.66      moko        4:        Copyright (c) 2001-2017 Art. Lebedev Studio (http://www.artlebedev.com)
1.31      paf         5:        Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.1       paf         6: */
                      7: 
                      8: #ifndef PA_EXCEPTION_H
                      9: #define PA_EXCEPTION_H
1.36      paf        10: 
1.67    ! moko       11: #define IDENT_PA_EXCEPTION_H "$Id: pa_exception.h,v 1.66 2017/02/07 22:00:34 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.48      misha      26: const char* const FILE_NAME_MUST_NOT_BE_CODE = "file name must not be code";
1.51      misha      27: const char* const FIRST_ARG_MUST_NOT_BE_CODE = "first argument must not be code";
                     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.51      misha      30: const char* const MODE_MUST_NOT_BE_CODE = "mode must not be code";
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