1 /*
2 +----------------------------------------------------------------------+
3 | Zend Engine |
4 +----------------------------------------------------------------------+
5 | Copyright (c) Zend Technologies Ltd. (http://www.zend.com) |
6 +----------------------------------------------------------------------+
7 | This source file is subject to version 2.00 of the Zend license, |
8 | that is bundled with this package in the file LICENSE, and is |
9 | available through the world-wide-web at the following url: |
10 | http://www.zend.com/license/2_00.txt. |
11 | If you did not receive a copy of the Zend license and are unable to |
12 | obtain it through the world-wide-web, please send a note to |
13 | license@zend.com so we can mail you a copy immediately. |
14 +----------------------------------------------------------------------+
15 | Authors: Andi Gutmans <andi@php.net> |
16 | Marcus Boerger <helly@php.net> |
17 | Sterling Hughes <sterling@php.net> |
18 | Zeev Suraski <zeev@php.net> |
19 +----------------------------------------------------------------------+
20 */
21
22 #ifndef ZEND_EXCEPTIONS_H
23 #define ZEND_EXCEPTIONS_H
24
25 BEGIN_EXTERN_C()
26
27 extern ZEND_API zend_class_entry *zend_ce_throwable;
28 extern ZEND_API zend_class_entry *zend_ce_exception;
29 extern ZEND_API zend_class_entry *zend_ce_error_exception;
30 extern ZEND_API zend_class_entry *zend_ce_error;
31 extern ZEND_API zend_class_entry *zend_ce_compile_error;
32 extern ZEND_API zend_class_entry *zend_ce_parse_error;
33 extern ZEND_API zend_class_entry *zend_ce_type_error;
34 extern ZEND_API zend_class_entry *zend_ce_argument_count_error;
35 extern ZEND_API zend_class_entry *zend_ce_arithmetic_error;
36 extern ZEND_API zend_class_entry *zend_ce_division_by_zero_error;
37
38 ZEND_API void zend_exception_set_previous(zend_object *exception, zend_object *add_previous);
39 ZEND_API void zend_exception_save(void);
40 ZEND_API void zend_exception_restore(void);
41
42 ZEND_API ZEND_COLD void zend_throw_exception_internal(zval *exception);
43
44 void zend_register_default_exception(void);
45
46 ZEND_API zend_class_entry *zend_get_exception_base(zval *object);
47
48 /* Deprecated - Use zend_ce_exception directly instead */
49 ZEND_API zend_class_entry *zend_exception_get_default(void);
50
51 /* Deprecated - Use zend_ce_error_exception directly instead */
52 ZEND_API zend_class_entry *zend_get_error_exception(void);
53
54 ZEND_API void zend_register_default_classes(void);
55
56 /* exception_ce NULL, zend_ce_exception, zend_ce_error, or a derived class
57 * message NULL or the message of the exception */
58 ZEND_API ZEND_COLD zend_object *zend_throw_exception(zend_class_entry *exception_ce, const char *message, zend_long code);
59 ZEND_API ZEND_COLD zend_object *zend_throw_exception_ex(zend_class_entry *exception_ce, zend_long code, const char *format, ...) ZEND_ATTRIBUTE_FORMAT(printf, 3, 4);
60 ZEND_API ZEND_COLD void zend_throw_exception_object(zval *exception);
61 ZEND_API void zend_clear_exception(void);
62
63 ZEND_API zend_object *zend_throw_error_exception(zend_class_entry *exception_ce, const char *message, zend_long code, int severity);
64
65 extern ZEND_API void (*zend_throw_exception_hook)(zval *ex);
66
67 /* show an exception using zend_error(severity,...), severity should be E_ERROR */
68 ZEND_API ZEND_COLD void zend_exception_error(zend_object *exception, int severity);
69
70 #include "zend_globals.h"
71
zend_rethrow_exception(zend_execute_data * execute_data)72 static zend_always_inline void zend_rethrow_exception(zend_execute_data *execute_data)
73 {
74 if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
75 EG(opline_before_exception) = EX(opline);
76 EX(opline) = EG(exception_op);
77 }
78 }
79
80 END_EXTERN_C()
81
82 #endif
83
