2 //===-------------------------- exception ---------------------------------===//
4 // The LLVM Compiler Infrastructure
6 // This file is dual licensed under the MIT and the University of Illinois Open
7 // Source Licenses. See LICENSE.TXT for details.
9 //===----------------------------------------------------------------------===//
11 #ifndef _LIBCPP_EXCEPTION
12 #define _LIBCPP_EXCEPTION
24 exception(const exception&) noexcept;
25 exception& operator=(const exception&) noexcept;
26 virtual ~exception() noexcept;
27 virtual const char* what() const noexcept;
34 bad_exception() noexcept;
35 bad_exception(const bad_exception&) noexcept;
36 bad_exception& operator=(const bad_exception&) noexcept;
37 virtual ~bad_exception() noexcept;
38 virtual const char* what() const noexcept;
41 typedef void (*unexpected_handler)();
42 unexpected_handler set_unexpected(unexpected_handler f ) noexcept;
43 unexpected_handler get_unexpected() noexcept;
44 [[noreturn]] void unexpected();
46 typedef void (*terminate_handler)();
47 terminate_handler set_terminate(terminate_handler f ) noexcept;
48 terminate_handler get_terminate() noexcept;
49 [[noreturn]] void terminate() noexcept;
51 bool uncaught_exception() noexcept;
52 int uncaught_exceptions() noexcept; // C++17
54 typedef unspecified exception_ptr;
56 exception_ptr current_exception() noexcept;
57 void rethrow_exception [[noreturn]] (exception_ptr p);
58 template<class E> exception_ptr make_exception_ptr(E e) noexcept;
60 class nested_exception
63 nested_exception() noexcept;
64 nested_exception(const nested_exception&) noexcept = default;
65 nested_exception& operator=(const nested_exception&) noexcept = default;
66 virtual ~nested_exception() = default;
69 [[noreturn]] void rethrow_nested() const;
70 exception_ptr nested_ptr() const noexcept;
73 template <class T> [[noreturn]] void throw_with_nested(T&& t);
74 template <class E> void rethrow_if_nested(const E& e);
83 #include <type_traits>
85 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
86 #pragma GCC system_header
89 namespace std // purposefully not using versioning namespace
92 class _LIBCPP_EXCEPTION_ABI exception
95 _LIBCPP_INLINE_VISIBILITY exception() _NOEXCEPT {}
96 virtual ~exception() _NOEXCEPT;
97 virtual const char* what() const _NOEXCEPT;
100 class _LIBCPP_EXCEPTION_ABI bad_exception
104 _LIBCPP_INLINE_VISIBILITY bad_exception() _NOEXCEPT {}
105 virtual ~bad_exception() _NOEXCEPT;
106 virtual const char* what() const _NOEXCEPT;
109 typedef void (*unexpected_handler)();
110 _LIBCPP_FUNC_VIS unexpected_handler set_unexpected(unexpected_handler) _NOEXCEPT;
111 _LIBCPP_FUNC_VIS unexpected_handler get_unexpected() _NOEXCEPT;
112 _LIBCPP_NORETURN _LIBCPP_FUNC_VIS void unexpected();
114 typedef void (*terminate_handler)();
115 _LIBCPP_FUNC_VIS terminate_handler set_terminate(terminate_handler) _NOEXCEPT;
116 _LIBCPP_FUNC_VIS terminate_handler get_terminate() _NOEXCEPT;
117 _LIBCPP_NORETURN _LIBCPP_FUNC_VIS void terminate() _NOEXCEPT;
119 _LIBCPP_FUNC_VIS bool uncaught_exception() _NOEXCEPT;
120 _LIBCPP_FUNC_VIS int uncaught_exceptions() _NOEXCEPT;
122 class _LIBCPP_TYPE_VIS exception_ptr;
124 _LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
125 _LIBCPP_NORETURN _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
127 class _LIBCPP_TYPE_VIS exception_ptr
131 _LIBCPP_INLINE_VISIBILITY exception_ptr() _NOEXCEPT : __ptr_() {}
132 _LIBCPP_INLINE_VISIBILITY exception_ptr(nullptr_t) _NOEXCEPT : __ptr_() {}
133 exception_ptr(const exception_ptr&) _NOEXCEPT;
134 exception_ptr& operator=(const exception_ptr&) _NOEXCEPT;
135 ~exception_ptr() _NOEXCEPT;
137 _LIBCPP_INLINE_VISIBILITY
139 operator bool() const _NOEXCEPT {return __ptr_ != nullptr;}
141 friend _LIBCPP_INLINE_VISIBILITY
142 bool operator==(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
143 {return __x.__ptr_ == __y.__ptr_;}
144 friend _LIBCPP_INLINE_VISIBILITY
145 bool operator!=(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
146 {return !(__x == __y);}
148 friend _LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
149 friend _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
154 make_exception_ptr(_Ep __e) _NOEXCEPT
156 #ifndef _LIBCPP_NO_EXCEPTIONS
163 return current_exception();
173 class _LIBCPP_EXCEPTION_ABI nested_exception
175 exception_ptr __ptr_;
177 nested_exception() _NOEXCEPT;
178 // nested_exception(const nested_exception&) noexcept = default;
179 // nested_exception& operator=(const nested_exception&) noexcept = default;
180 virtual ~nested_exception() _NOEXCEPT;
183 _LIBCPP_NORETURN void rethrow_nested() const;
184 _LIBCPP_INLINE_VISIBILITY exception_ptr nested_ptr() const _NOEXCEPT {return __ptr_;}
190 public nested_exception
192 _LIBCPP_INLINE_VISIBILITY explicit __nested(const _Tp& __t) : _Tp(__t) {}
198 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
199 throw_with_nested(_Tp&& __t, typename enable_if<
200 is_class<typename remove_reference<_Tp>::type>::value &&
201 !is_base_of<nested_exception, typename remove_reference<_Tp>::type>::value
202 && !__libcpp_is_final<typename remove_reference<_Tp>::type>::value
204 #else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
205 throw_with_nested (_Tp& __t, typename enable_if<
206 is_class<_Tp>::value && !is_base_of<nested_exception, _Tp>::value
208 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
210 #ifndef _LIBCPP_NO_EXCEPTIONS
211 throw __nested<typename remove_reference<_Tp>::type>(_VSTD::forward<_Tp>(__t));
214 // FIXME: Make this abort.
221 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
222 throw_with_nested(_Tp&& __t, typename enable_if<
223 !is_class<typename remove_reference<_Tp>::type>::value ||
224 is_base_of<nested_exception, typename remove_reference<_Tp>::type>::value
225 || __libcpp_is_final<typename remove_reference<_Tp>::type>::value
227 #else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
228 throw_with_nested (_Tp& __t, typename enable_if<
229 !is_class<_Tp>::value || is_base_of<nested_exception, _Tp>::value
231 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
233 #ifndef _LIBCPP_NO_EXCEPTIONS
234 throw _VSTD::forward<_Tp>(__t);
237 // FIXME: Make this abort
242 inline _LIBCPP_INLINE_VISIBILITY
244 rethrow_if_nested(const _Ep& __e, typename enable_if<
245 is_polymorphic<_Ep>::value
248 const nested_exception* __nep = dynamic_cast<const nested_exception*>(_VSTD::addressof(__e));
250 __nep->rethrow_nested();
254 inline _LIBCPP_INLINE_VISIBILITY
256 rethrow_if_nested(const _Ep&, typename enable_if<
257 !is_polymorphic<_Ep>::value
264 #endif // _LIBCPP_EXCEPTION