blob: c7dcac2b2b334b1b5af06e99d8227bdeb7307135 [file] [log] [blame]
Howard Hinnant3e519522010-05-11 19:42:161// -*- C++ -*-
2//===-------------------------- exception ---------------------------------===//
3//
Chandler Carruth57b08b02019-01-19 10:56:404// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
Howard Hinnant3e519522010-05-11 19:42:167//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_EXCEPTION
11#define _LIBCPP_EXCEPTION
12
13/*
14 exception synopsis
15
16namespace std
17{
18
19class exception
20{
21public:
Howard Hinnantfafca582011-05-26 18:23:5922 exception() noexcept;
23 exception(const exception&) noexcept;
24 exception& operator=(const exception&) noexcept;
25 virtual ~exception() noexcept;
26 virtual const char* what() const noexcept;
Howard Hinnant3e519522010-05-11 19:42:1627};
28
29class bad_exception
30 : public exception
31{
32public:
Howard Hinnantfafca582011-05-26 18:23:5933 bad_exception() noexcept;
34 bad_exception(const bad_exception&) noexcept;
35 bad_exception& operator=(const bad_exception&) noexcept;
36 virtual ~bad_exception() noexcept;
37 virtual const char* what() const noexcept;
Howard Hinnant3e519522010-05-11 19:42:1638};
39
40typedef void (*unexpected_handler)();
Howard Hinnantfafca582011-05-26 18:23:5941unexpected_handler set_unexpected(unexpected_handler f ) noexcept;
42unexpected_handler get_unexpected() noexcept;
43[[noreturn]] void unexpected();
Howard Hinnant3e519522010-05-11 19:42:1644
45typedef void (*terminate_handler)();
Howard Hinnantfafca582011-05-26 18:23:5946terminate_handler set_terminate(terminate_handler f ) noexcept;
47terminate_handler get_terminate() noexcept;
48[[noreturn]] void terminate() noexcept;
Howard Hinnant3e519522010-05-11 19:42:1649
Marshall Clow89102f02015-06-02 15:33:3850bool uncaught_exception() noexcept;
51int uncaught_exceptions() noexcept; // C++17
Howard Hinnant3e519522010-05-11 19:42:1652
53typedef unspecified exception_ptr;
54
Howard Hinnantfafca582011-05-26 18:23:5955exception_ptr current_exception() noexcept;
Howard Hinnant3e519522010-05-11 19:42:1656void rethrow_exception [[noreturn]] (exception_ptr p);
Howard Hinnantfafca582011-05-26 18:23:5957template<class E> exception_ptr make_exception_ptr(E e) noexcept;
Howard Hinnant3e519522010-05-11 19:42:1658
59class nested_exception
60{
61public:
Howard Hinnantfafca582011-05-26 18:23:5962 nested_exception() noexcept;
63 nested_exception(const nested_exception&) noexcept = default;
64 nested_exception& operator=(const nested_exception&) noexcept = default;
Howard Hinnant3e519522010-05-11 19:42:1665 virtual ~nested_exception() = default;
66
67 // access functions
Howard Hinnantfafca582011-05-26 18:23:5968 [[noreturn]] void rethrow_nested() const;
69 exception_ptr nested_ptr() const noexcept;
Howard Hinnant3e519522010-05-11 19:42:1670};
71
Howard Hinnantfafca582011-05-26 18:23:5972template <class T> [[noreturn]] void throw_with_nested(T&& t);
Howard Hinnant3e519522010-05-11 19:42:1673template <class E> void rethrow_if_nested(const E& e);
74
75} // std
76
77*/
78
79#include <__config>
80#include <cstddef>
Eric Fiselier613dc642016-12-03 03:22:1181#include <cstdlib>
Howard Hinnant019fe4b2010-05-27 17:06:5282#include <type_traits>
Marshall Clowf56972e2018-09-12 19:41:4083#include <version>
Howard Hinnant3e519522010-05-11 19:42:1684
Eric Fiseliere69290d2019-03-05 01:57:0185#if defined(_LIBCPP_ABI_VCRUNTIME)
Eric Fiselierd22c9dc2017-02-10 08:57:3586#include <vcruntime_exception.h>
87#endif
88
Howard Hinnant073458b2011-10-17 20:05:1089#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Howard Hinnant3e519522010-05-11 19:42:1690#pragma GCC system_header
Howard Hinnant073458b2011-10-17 20:05:1091#endif
Howard Hinnant3e519522010-05-11 19:42:1692
93namespace std // purposefully not using versioning namespace
94{
95
Eric Fiseliere69290d2019-03-05 01:57:0196#if !defined(_LIBCPP_ABI_VCRUNTIME)
Howard Hinnant3e519522010-05-11 19:42:1697class _LIBCPP_EXCEPTION_ABI exception
98{
99public:
Howard Hinnantfafca582011-05-26 18:23:59100 _LIBCPP_INLINE_VISIBILITY exception() _NOEXCEPT {}
101 virtual ~exception() _NOEXCEPT;
102 virtual const char* what() const _NOEXCEPT;
Howard Hinnant3e519522010-05-11 19:42:16103};
104
105class _LIBCPP_EXCEPTION_ABI bad_exception
106 : public exception
107{
108public:
Howard Hinnantfafca582011-05-26 18:23:59109 _LIBCPP_INLINE_VISIBILITY bad_exception() _NOEXCEPT {}
110 virtual ~bad_exception() _NOEXCEPT;
111 virtual const char* what() const _NOEXCEPT;
Howard Hinnant3e519522010-05-11 19:42:16112};
Eric Fiseliere69290d2019-03-05 01:57:01113#endif // !_LIBCPP_ABI_VCRUNTIME
Howard Hinnant3e519522010-05-11 19:42:16114
Eric Fiselier2a1bfa92017-02-17 03:25:08115#if _LIBCPP_STD_VER <= 14 \
116 || defined(_LIBCPP_ENABLE_CXX17_REMOVED_UNEXPECTED_FUNCTIONS) \
117 || defined(_LIBCPP_BUILDING_LIBRARY)
Howard Hinnant3e519522010-05-11 19:42:16118typedef void (*unexpected_handler)();
Howard Hinnant6e412562013-03-06 23:30:19119_LIBCPP_FUNC_VIS unexpected_handler set_unexpected(unexpected_handler) _NOEXCEPT;
120_LIBCPP_FUNC_VIS unexpected_handler get_unexpected() _NOEXCEPT;
121_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void unexpected();
Eric Fiselier2a1bfa92017-02-17 03:25:08122#endif
Howard Hinnant3e519522010-05-11 19:42:16123
124typedef void (*terminate_handler)();
Howard Hinnant6e412562013-03-06 23:30:19125_LIBCPP_FUNC_VIS terminate_handler set_terminate(terminate_handler) _NOEXCEPT;
126_LIBCPP_FUNC_VIS terminate_handler get_terminate() _NOEXCEPT;
127_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void terminate() _NOEXCEPT;
Howard Hinnant3e519522010-05-11 19:42:16128
Howard Hinnant6e412562013-03-06 23:30:19129_LIBCPP_FUNC_VIS bool uncaught_exception() _NOEXCEPT;
Mehdi Aminie9c66ad2017-05-04 17:08:54130_LIBCPP_FUNC_VIS _LIBCPP_AVAILABILITY_UNCAUGHT_EXCEPTIONS int uncaught_exceptions() _NOEXCEPT;
Howard Hinnant3e519522010-05-11 19:42:16131
Howard Hinnant6e412562013-03-06 23:30:19132class _LIBCPP_TYPE_VIS exception_ptr;
Howard Hinnant3e519522010-05-11 19:42:16133
Howard Hinnantf0544c22013-08-12 18:38:34134_LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
135_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
Howard Hinnant3e519522010-05-11 19:42:16136
Eric Fiselier3e254a62017-05-08 01:17:50137#ifndef _LIBCPP_ABI_MICROSOFT
138
Howard Hinnant6e412562013-03-06 23:30:19139class _LIBCPP_TYPE_VIS exception_ptr
Howard Hinnant3e519522010-05-11 19:42:16140{
141 void* __ptr_;
142public:
Howard Hinnantfafca582011-05-26 18:23:59143 _LIBCPP_INLINE_VISIBILITY exception_ptr() _NOEXCEPT : __ptr_() {}
144 _LIBCPP_INLINE_VISIBILITY exception_ptr(nullptr_t) _NOEXCEPT : __ptr_() {}
Eric Fiselier3e254a62017-05-08 01:17:50145
Howard Hinnantfafca582011-05-26 18:23:59146 exception_ptr(const exception_ptr&) _NOEXCEPT;
147 exception_ptr& operator=(const exception_ptr&) _NOEXCEPT;
148 ~exception_ptr() _NOEXCEPT;
Howard Hinnant3e519522010-05-11 19:42:16149
Eric Fiselier3e254a62017-05-08 01:17:50150 _LIBCPP_INLINE_VISIBILITY _LIBCPP_EXPLICIT operator bool() const _NOEXCEPT
151 {return __ptr_ != nullptr;}
Howard Hinnant3e519522010-05-11 19:42:16152
Howard Hinnantfb100022010-09-21 21:28:23153 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnantfafca582011-05-26 18:23:59154 bool operator==(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnant3e519522010-05-11 19:42:16155 {return __x.__ptr_ == __y.__ptr_;}
Eric Fiselier3e254a62017-05-08 01:17:50156
Howard Hinnantfb100022010-09-21 21:28:23157 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnantfafca582011-05-26 18:23:59158 bool operator!=(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnant3e519522010-05-11 19:42:16159 {return !(__x == __y);}
160
Howard Hinnantf0544c22013-08-12 18:38:34161 friend _LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
162 friend _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
Howard Hinnant3e519522010-05-11 19:42:16163};
164
Howard Hinnantc003db12011-11-29 18:15:50165template<class _Ep>
Louis Dionne352adb62018-11-21 17:00:52166_LIBCPP_INLINE_VISIBILITY exception_ptr
Howard Hinnantc003db12011-11-29 18:15:50167make_exception_ptr(_Ep __e) _NOEXCEPT
Howard Hinnant3e519522010-05-11 19:42:16168{
Howard Hinnant54b409f2010-08-11 17:04:31169#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnant3e519522010-05-11 19:42:16170 try
171 {
172 throw __e;
173 }
174 catch (...)
175 {
176 return current_exception();
177 }
Eric Fiselier613dc642016-12-03 03:22:11178#else
Eric Fiselierfd838222016-12-23 23:37:52179 ((void)__e);
Eric Fiselier613dc642016-12-03 03:22:11180 _VSTD::abort();
181#endif
Howard Hinnant3e519522010-05-11 19:42:16182}
183
Eric Fiselier3e254a62017-05-08 01:17:50184#else // _LIBCPP_ABI_MICROSOFT
185
186class _LIBCPP_TYPE_VIS exception_ptr
187{
188#if defined(__clang__)
189#pragma clang diagnostic push
190#pragma clang diagnostic ignored "-Wunused-private-field"
191#endif
192 void* __ptr1_;
193 void* __ptr2_;
194#if defined(__clang__)
195#pragma clang diagnostic pop
196#endif
197public:
198 exception_ptr() _NOEXCEPT;
199 exception_ptr(nullptr_t) _NOEXCEPT;
200 exception_ptr(const exception_ptr& __other) _NOEXCEPT;
201 exception_ptr& operator=(const exception_ptr& __other) _NOEXCEPT;
202 exception_ptr& operator=(nullptr_t) _NOEXCEPT;
203 ~exception_ptr() _NOEXCEPT;
204 _LIBCPP_EXPLICIT operator bool() const _NOEXCEPT;
205};
206
207_LIBCPP_FUNC_VIS
208bool operator==(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT;
209
210inline _LIBCPP_INLINE_VISIBILITY
211bool operator!=(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
212 {return !(__x == __y);}
213
214_LIBCPP_FUNC_VIS void swap(exception_ptr&, exception_ptr&) _NOEXCEPT;
215
216_LIBCPP_FUNC_VIS exception_ptr __copy_exception_ptr(void *__except, const void* __ptr);
217_LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
218_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr p);
219
220// This is a built-in template function which automagically extracts the required
221// information.
222template <class _E> void *__GetExceptionInfo(_E);
223
224template<class _Ep>
Louis Dionne352adb62018-11-21 17:00:52225_LIBCPP_INLINE_VISIBILITY exception_ptr
Eric Fiselier3e254a62017-05-08 01:17:50226make_exception_ptr(_Ep __e) _NOEXCEPT
227{
228 return __copy_exception_ptr(_VSTD::addressof(__e), __GetExceptionInfo(__e));
229}
230
231#endif // _LIBCPP_ABI_MICROSOFT
Howard Hinnant019fe4b2010-05-27 17:06:52232// nested_exception
233
234class _LIBCPP_EXCEPTION_ABI nested_exception
235{
236 exception_ptr __ptr_;
237public:
Howard Hinnantfafca582011-05-26 18:23:59238 nested_exception() _NOEXCEPT;
239// nested_exception(const nested_exception&) noexcept = default;
240// nested_exception& operator=(const nested_exception&) noexcept = default;
241 virtual ~nested_exception() _NOEXCEPT;
Howard Hinnant019fe4b2010-05-27 17:06:52242
243 // access functions
Richard Smith535a86c2012-07-26 02:04:22244 _LIBCPP_NORETURN void rethrow_nested() const;
Howard Hinnantfafca582011-05-26 18:23:59245 _LIBCPP_INLINE_VISIBILITY exception_ptr nested_ptr() const _NOEXCEPT {return __ptr_;}
Howard Hinnant019fe4b2010-05-27 17:06:52246};
247
248template <class _Tp>
249struct __nested
250 : public _Tp,
251 public nested_exception
252{
Howard Hinnantfb100022010-09-21 21:28:23253 _LIBCPP_INLINE_VISIBILITY explicit __nested(const _Tp& __t) : _Tp(__t) {}
Howard Hinnant019fe4b2010-05-27 17:06:52254};
255
Howard Hinnant54b409f2010-08-11 17:04:31256#ifndef _LIBCPP_NO_EXCEPTIONS
Marshall Clowe9ca2bb2017-04-13 14:41:45257template <class _Tp, class _Up, bool>
258struct __throw_with_nested;
259
260template <class _Tp, class _Up>
261struct __throw_with_nested<_Tp, _Up, true> {
Louis Dionnedc7200b2018-07-11 23:14:33262 _LIBCPP_NORETURN static inline _LIBCPP_INLINE_VISIBILITY void
Marshall Clowe9ca2bb2017-04-13 14:41:45263 __do_throw(_Tp&& __t)
Marshall Clowe9ca2bb2017-04-13 14:41:45264 {
265 throw __nested<_Up>(_VSTD::forward<_Tp>(__t));
266 }
267};
268
269template <class _Tp, class _Up>
270struct __throw_with_nested<_Tp, _Up, false> {
Louis Dionnedc7200b2018-07-11 23:14:33271 _LIBCPP_NORETURN static inline _LIBCPP_INLINE_VISIBILITY void
Eric Fiselier6ded58e2017-04-19 01:35:58272#ifndef _LIBCPP_CXX03_LANG
Marshall Clowe9ca2bb2017-04-13 14:41:45273 __do_throw(_Tp&& __t)
Eric Fiselier6ded58e2017-04-19 01:35:58274#else
Marshall Clowe9ca2bb2017-04-13 14:41:45275 __do_throw (_Tp& __t)
Eric Fiselier6ded58e2017-04-19 01:35:58276#endif // _LIBCPP_CXX03_LANG
Marshall Clowe9ca2bb2017-04-13 14:41:45277 {
278 throw _VSTD::forward<_Tp>(__t);
279 }
280};
Howard Hinnant54b409f2010-08-11 17:04:31281#endif
Howard Hinnant019fe4b2010-05-27 17:06:52282
283template <class _Tp>
Richard Smith535a86c2012-07-26 02:04:22284_LIBCPP_NORETURN
Howard Hinnantb3371f62010-08-22 00:02:43285void
Marshall Clowe9ca2bb2017-04-13 14:41:45286throw_with_nested(_Tp&& __t)
Howard Hinnant019fe4b2010-05-27 17:06:52287{
Howard Hinnant54b409f2010-08-11 17:04:31288#ifndef _LIBCPP_NO_EXCEPTIONS
Marshall Clow5948e392017-04-13 16:57:42289 typedef typename decay<_Tp>::type _Up;
290 static_assert( is_copy_constructible<_Up>::value, "type thrown must be CopyConstructible");
Marshall Clowe9ca2bb2017-04-13 14:41:45291 __throw_with_nested<_Tp, _Up,
292 is_class<_Up>::value &&
293 !is_base_of<nested_exception, _Up>::value &&
294 !__libcpp_is_final<_Up>::value>::
295 __do_throw(_VSTD::forward<_Tp>(__t));
Eric Fiselierfd838222016-12-23 23:37:52296#else
297 ((void)__t);
298 // FIXME: Make this abort
Howard Hinnant54b409f2010-08-11 17:04:31299#endif
Howard Hinnant019fe4b2010-05-27 17:06:52300}
301
Marshall Clow55cfe4c2017-03-14 17:08:47302template <class _From, class _To>
303struct __can_dynamic_cast : public _LIBCPP_BOOL_CONSTANT(
304 is_polymorphic<_From>::value &&
305 (!is_base_of<_To, _From>::value ||
306 is_convertible<const _From*, const _To*>::value)) {};
307
Howard Hinnantc003db12011-11-29 18:15:50308template <class _Ep>
Howard Hinnantfb100022010-09-21 21:28:23309inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnant019fe4b2010-05-27 17:06:52310void
Marshall Clow55cfe4c2017-03-14 17:08:47311rethrow_if_nested(const _Ep& __e,
312 typename enable_if< __can_dynamic_cast<_Ep, nested_exception>::value>::type* = 0)
Howard Hinnant019fe4b2010-05-27 17:06:52313{
Marshall Clow94b5bc42015-12-14 18:01:56314 const nested_exception* __nep = dynamic_cast<const nested_exception*>(_VSTD::addressof(__e));
Howard Hinnanta391bc12010-05-28 13:35:41315 if (__nep)
316 __nep->rethrow_nested();
Howard Hinnant019fe4b2010-05-27 17:06:52317}
318
Howard Hinnantc003db12011-11-29 18:15:50319template <class _Ep>
Howard Hinnantfb100022010-09-21 21:28:23320inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnant019fe4b2010-05-27 17:06:52321void
Marshall Clow55cfe4c2017-03-14 17:08:47322rethrow_if_nested(const _Ep&,
323 typename enable_if<!__can_dynamic_cast<_Ep, nested_exception>::value>::type* = 0)
Howard Hinnant019fe4b2010-05-27 17:06:52324{
325}
326
Howard Hinnant3e519522010-05-11 19:42:16327} // std
328
Howard Hinnant3e519522010-05-11 19:42:16329#endif // _LIBCPP_EXCEPTION