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
25BEGIN_EXTERN_C()
26
27extern ZEND_API zend_class_entry *zend_ce_throwable;
28extern ZEND_API zend_class_entry *zend_ce_exception;
29extern ZEND_API zend_class_entry *zend_ce_error_exception;
30extern ZEND_API zend_class_entry *zend_ce_error;
31extern ZEND_API zend_class_entry *zend_ce_compile_error;
32extern ZEND_API zend_class_entry *zend_ce_parse_error;
33extern ZEND_API zend_class_entry *zend_ce_type_error;
34extern ZEND_API zend_class_entry *zend_ce_argument_count_error;
35extern ZEND_API zend_class_entry *zend_ce_value_error;
36extern ZEND_API zend_class_entry *zend_ce_arithmetic_error;
37extern ZEND_API zend_class_entry *zend_ce_division_by_zero_error;
38
39ZEND_API void zend_exception_set_previous(zend_object *exception, zend_object *add_previous);
40ZEND_API void zend_exception_save(void);
41ZEND_API void zend_exception_restore(void);
42
43ZEND_API ZEND_COLD void zend_throw_exception_internal(zval *exception);
44
45void zend_register_default_exception(void);
46
47ZEND_API zend_class_entry *zend_get_exception_base(zval *object);
48
49/* Deprecated - Use zend_ce_exception directly instead */
50ZEND_API zend_class_entry *zend_exception_get_default(void);
51
52/* Deprecated - Use zend_ce_error_exception directly instead */
53ZEND_API zend_class_entry *zend_get_error_exception(void);
54
55ZEND_API void zend_register_default_classes(void);
56
57/* exception_ce   NULL, zend_ce_exception, zend_ce_error, or a derived class
58 * message        NULL or the message of the exception */
59ZEND_API ZEND_COLD zend_object *zend_throw_exception(zend_class_entry *exception_ce, const char *message, zend_long code);
60ZEND_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);
61ZEND_API ZEND_COLD void zend_throw_exception_object(zval *exception);
62ZEND_API void zend_clear_exception(void);
63
64ZEND_API zend_object *zend_throw_error_exception(zend_class_entry *exception_ce, const char *message, zend_long code, int severity);
65
66extern ZEND_API void (*zend_throw_exception_hook)(zval *ex);
67
68/* show an exception using zend_error(severity,...), severity should be E_ERROR */
69ZEND_API ZEND_COLD void zend_exception_error(zend_object *exception, int severity);
70
71#include "zend_globals.h"
72
73static zend_always_inline void zend_rethrow_exception(zend_execute_data *execute_data)
74{
75	if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
76		EG(opline_before_exception) = EX(opline);
77		EX(opline) = EG(exception_op);
78	}
79}
80
81END_EXTERN_C()
82
83#endif
84