1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
/* GNU Objective C Runtime native exceptions
Copyright (C) 2010 Free Software Foundation, Inc.
Contributed by Nicola Pero <nicola.pero@meta-innovation.com>
This file is part of GCC.
GCC is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.
GCC is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
Under Section 7 of GPL version 3, you are granted additional
permissions described in the GCC Runtime Library Exception, version
3.1, as published by the Free Software Foundation.
You should have received a copy of the GNU General Public License and
a copy of the GCC Runtime Library Exception along with this program;
see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
<http://www.gnu.org/licenses/>. */
#ifndef __objc_exception_INCLUDE_GNU
#define __objc_exception_INCLUDE_GNU
#include <objc/objc.h>
#ifdef __cplusplus
extern "C" {
#endif
/* 'objc_exception_throw' throws the exception 'exception', which is
an exception object.
Calls to 'objc_exception_throw' are automatically generated by the
compiler: an Objective-C "@throw exception;" statement gets
compiled into the equivalent of "objc_exception_throw
(exception);".
'objc_exception_throw' searches for a @catch() that can catch the
exception. By default, @catch (MyClass object) will catch all
exception objects that are of class MyClass or of a subclass of
MyClass; if the exception object is 'nil', then the exception can
only be caught with a catch-all exception handler where no
exception class is specified (such as @catch(id object)). This
behaviour can be customized by setting an 'objc_exception_matcher'
function (using objc_set_exception_matcher(), see below); if one is
set, it is used instead of the default one.
If the exception is uncaught (there is no @catch() to catch it),
the program aborts. It is possible to customize this behaviour by
setting an 'objc_uncaught_exception_handler' function (using
objc_set_uncaught_exception_handler(), see below); if one is set,
it is executed before abort() is called. An uncaught exception
handler is expected to never return.
*/
void objc_exception_throw (id exception);
/* PS: the Apple runtime seems to also have objc_exception_rethrow(),
objc_begin_catch() and objc_end_catch(). Currently the GNU runtime
does not use them.
*/
/* The following functions allow customizing to a certain extent the
exception handling. They are not thread safe and should be called
during the program initialization before threads are started. They
are mostly reserved for "Foundation" libraries; in the case of
GNUstep, gnustep-base may be using these functions to improve the
standard exception handling. You probably shouldn't use these
functions unless you are writing your own Foundation library.
*/
/* PS: objc_set_exception_preprocessor() (available on the Apple
runtime) is not supported on the GNU runtime. */
/* An 'objc_exception_matcher' function is used to match an exception
to a @catch clause. 'catch_class' is the class of objects caught
by the @catch clause (for example, in "@catch (Object *o)", the
catch_class is Object). It should return 1 if the exception should
be caught by a @catch with a catch_class argument, and 0 if
not. */
typedef int (*objc_exception_matcher)(Class catch_class, id exception);
/* Sets a new exception matcher function, and returns the previous
exception matcher function. This function is not safe to call in a
multi-threaded environment because other threads may be trying to
invoke the exception matcher while you change it! */
objc_exception_matcher
objc_set_exception_matcher (objc_exception_matcher new_matcher);
/* An 'objc_uncaught_exception_handler' function is a function that
handles uncaught exceptions. It should never return. */
typedef void (*objc_uncaught_exception_handler)(id exception);
/* Sets a new uncaught exception handler function, and returns the
previous exception handler function. This function is not safe to
call in a multi-threaded environment because other threads may be
trying to invoke the uncaught exception handler while you change
it.
*/
objc_uncaught_exception_handler
objc_set_uncaught_exception_handler (objc_uncaught_exception_handler new_handler);
/* For compatibility with the Apple runtime. */
#define objc_setExceptionMatcher objc_set_exception_matcher
#define objc_setUncaughtExceptionHandler objc_set_uncaught_exception_handler
#ifdef __cplusplus
}
#endif
#endif /* not __objc_exception_INCLUDE_GNU */
|
