blob: 98e1f37f919ef0f9c8098136f25a21b3b8a3d163 [file] [log] [blame]
Howard Hinnantc51e1022010-05-11 19:42:16 +00001// -*- C++ -*-
2//===-------------------------- exception ---------------------------------===//
3//
Howard Hinnantc566dc32010-05-11 21:36:01 +00004// The LLVM Compiler Infrastructure
Howard Hinnantc51e1022010-05-11 19:42:16 +00005//
Howard Hinnantee11c312010-11-16 22:09:02 +00006// This file is dual licensed under the MIT and the University of Illinois Open
7// Source Licenses. See LICENSE.TXT for details.
Howard Hinnantc51e1022010-05-11 19:42:16 +00008//
9//===----------------------------------------------------------------------===//
10
11#ifndef _LIBCPP_EXCEPTION
12#define _LIBCPP_EXCEPTION
13
14/*
15 exception synopsis
16
17namespace std
18{
19
20class exception
21{
22public:
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000023 exception() noexcept;
24 exception(const exception&) noexcept;
25 exception& operator=(const exception&) noexcept;
26 virtual ~exception() noexcept;
27 virtual const char* what() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +000028};
29
30class bad_exception
31 : public exception
32{
33public:
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000034 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;
Howard Hinnantc51e1022010-05-11 19:42:16 +000039};
40
41typedef void (*unexpected_handler)();
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000042unexpected_handler set_unexpected(unexpected_handler f ) noexcept;
43unexpected_handler get_unexpected() noexcept;
44[[noreturn]] void unexpected();
Howard Hinnantc51e1022010-05-11 19:42:16 +000045
46typedef void (*terminate_handler)();
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000047terminate_handler set_terminate(terminate_handler f ) noexcept;
48terminate_handler get_terminate() noexcept;
49[[noreturn]] void terminate() noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +000050
Marshall Clow209dacc2015-06-02 15:33:38 +000051bool uncaught_exception() noexcept;
52int uncaught_exceptions() noexcept; // C++17
Howard Hinnantc51e1022010-05-11 19:42:16 +000053
54typedef unspecified exception_ptr;
55
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000056exception_ptr current_exception() noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +000057void rethrow_exception [[noreturn]] (exception_ptr p);
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000058template<class E> exception_ptr make_exception_ptr(E e) noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +000059
60class nested_exception
61{
62public:
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000063 nested_exception() noexcept;
64 nested_exception(const nested_exception&) noexcept = default;
65 nested_exception& operator=(const nested_exception&) noexcept = default;
Howard Hinnantc51e1022010-05-11 19:42:16 +000066 virtual ~nested_exception() = default;
67
68 // access functions
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000069 [[noreturn]] void rethrow_nested() const;
70 exception_ptr nested_ptr() const noexcept;
Howard Hinnantc51e1022010-05-11 19:42:16 +000071};
72
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000073template <class T> [[noreturn]] void throw_with_nested(T&& t);
Howard Hinnantc51e1022010-05-11 19:42:16 +000074template <class E> void rethrow_if_nested(const E& e);
75
76} // std
77
78*/
79
80#include <__config>
81#include <cstddef>
Eric Fiselieraae1ccf2016-12-03 03:22:11 +000082#include <cstdlib>
Howard Hinnante4f92722010-05-27 17:06:52 +000083#include <type_traits>
Howard Hinnantc51e1022010-05-11 19:42:16 +000084
Howard Hinnantaaaa52b2011-10-17 20:05:10 +000085#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Howard Hinnantc51e1022010-05-11 19:42:16 +000086#pragma GCC system_header
Howard Hinnantaaaa52b2011-10-17 20:05:10 +000087#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +000088
89namespace std // purposefully not using versioning namespace
90{
91
92class _LIBCPP_EXCEPTION_ABI exception
93{
94public:
Howard Hinnant1bc52cf2011-05-26 18:23:59 +000095 _LIBCPP_INLINE_VISIBILITY exception() _NOEXCEPT {}
96 virtual ~exception() _NOEXCEPT;
97 virtual const char* what() const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +000098};
99
100class _LIBCPP_EXCEPTION_ABI bad_exception
101 : public exception
102{
103public:
Howard Hinnant1bc52cf2011-05-26 18:23:59 +0000104 _LIBCPP_INLINE_VISIBILITY bad_exception() _NOEXCEPT {}
105 virtual ~bad_exception() _NOEXCEPT;
106 virtual const char* what() const _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000107};
108
109typedef void (*unexpected_handler)();
Howard Hinnant8331b762013-03-06 23:30:19 +0000110_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();
Howard Hinnantc51e1022010-05-11 19:42:16 +0000113
114typedef void (*terminate_handler)();
Howard Hinnant8331b762013-03-06 23:30:19 +0000115_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;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000118
Howard Hinnant8331b762013-03-06 23:30:19 +0000119_LIBCPP_FUNC_VIS bool uncaught_exception() _NOEXCEPT;
Marshall Clow209dacc2015-06-02 15:33:38 +0000120_LIBCPP_FUNC_VIS int uncaught_exceptions() _NOEXCEPT;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000121
Howard Hinnant8331b762013-03-06 23:30:19 +0000122class _LIBCPP_TYPE_VIS exception_ptr;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000123
Howard Hinnanta37d3cf2013-08-12 18:38:34 +0000124_LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
125_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000126
Howard Hinnant8331b762013-03-06 23:30:19 +0000127class _LIBCPP_TYPE_VIS exception_ptr
Howard Hinnantc51e1022010-05-11 19:42:16 +0000128{
129 void* __ptr_;
130public:
Howard Hinnant1bc52cf2011-05-26 18:23:59 +0000131 _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;
Howard Hinnantc51e1022010-05-11 19:42:16 +0000136
Howard Hinnant874ad9a2010-09-21 21:28:23 +0000137 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant86a291f2012-02-21 21:46:43 +0000138 _LIBCPP_EXPLICIT
Howard Hinnant1bc52cf2011-05-26 18:23:59 +0000139 operator bool() const _NOEXCEPT {return __ptr_ != nullptr;}
Howard Hinnantc51e1022010-05-11 19:42:16 +0000140
Howard Hinnant874ad9a2010-09-21 21:28:23 +0000141 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnant1bc52cf2011-05-26 18:23:59 +0000142 bool operator==(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +0000143 {return __x.__ptr_ == __y.__ptr_;}
Howard Hinnant874ad9a2010-09-21 21:28:23 +0000144 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnant1bc52cf2011-05-26 18:23:59 +0000145 bool operator!=(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +0000146 {return !(__x == __y);}
147
Howard Hinnanta37d3cf2013-08-12 18:38:34 +0000148 friend _LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
149 friend _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
Howard Hinnantc51e1022010-05-11 19:42:16 +0000150};
151
Howard Hinnantc834c512011-11-29 18:15:50 +0000152template<class _Ep>
Howard Hinnantc51e1022010-05-11 19:42:16 +0000153exception_ptr
Howard Hinnantc834c512011-11-29 18:15:50 +0000154make_exception_ptr(_Ep __e) _NOEXCEPT
Howard Hinnantc51e1022010-05-11 19:42:16 +0000155{
Howard Hinnant72f73582010-08-11 17:04:31 +0000156#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnantc51e1022010-05-11 19:42:16 +0000157 try
158 {
159 throw __e;
160 }
161 catch (...)
162 {
163 return current_exception();
164 }
Eric Fiselieraae1ccf2016-12-03 03:22:11 +0000165#else
Eric Fiselier6003c772016-12-23 23:37:52 +0000166 ((void)__e);
Eric Fiselieraae1ccf2016-12-03 03:22:11 +0000167 _VSTD::abort();
168#endif
Howard Hinnantc51e1022010-05-11 19:42:16 +0000169}
170
Howard Hinnante4f92722010-05-27 17:06:52 +0000171// nested_exception
172
173class _LIBCPP_EXCEPTION_ABI nested_exception
174{
175 exception_ptr __ptr_;
176public:
Howard Hinnant1bc52cf2011-05-26 18:23:59 +0000177 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;
Howard Hinnante4f92722010-05-27 17:06:52 +0000181
182 // access functions
Richard Smithcabd3922012-07-26 02:04:22 +0000183 _LIBCPP_NORETURN void rethrow_nested() const;
Howard Hinnant1bc52cf2011-05-26 18:23:59 +0000184 _LIBCPP_INLINE_VISIBILITY exception_ptr nested_ptr() const _NOEXCEPT {return __ptr_;}
Howard Hinnante4f92722010-05-27 17:06:52 +0000185};
186
187template <class _Tp>
188struct __nested
189 : public _Tp,
190 public nested_exception
191{
Howard Hinnant874ad9a2010-09-21 21:28:23 +0000192 _LIBCPP_INLINE_VISIBILITY explicit __nested(const _Tp& __t) : _Tp(__t) {}
Howard Hinnante4f92722010-05-27 17:06:52 +0000193};
194
195template <class _Tp>
Richard Smithcabd3922012-07-26 02:04:22 +0000196_LIBCPP_NORETURN
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000197void
Howard Hinnant74279a52010-09-04 23:28:19 +0000198#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnant8df96292011-05-26 17:07:32 +0000199throw_with_nested(_Tp&& __t, typename enable_if<
Howard Hinnante4f92722010-05-27 17:06:52 +0000200 is_class<typename remove_reference<_Tp>::type>::value &&
201 !is_base_of<nested_exception, typename remove_reference<_Tp>::type>::value
Eric Fiselierf7394302015-06-13 07:08:02 +0000202 && !__libcpp_is_final<typename remove_reference<_Tp>::type>::value
Howard Hinnante4f92722010-05-27 17:06:52 +0000203 >::type* = 0)
Howard Hinnant74279a52010-09-04 23:28:19 +0000204#else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnante4f92722010-05-27 17:06:52 +0000205throw_with_nested (_Tp& __t, typename enable_if<
206 is_class<_Tp>::value && !is_base_of<nested_exception, _Tp>::value
207 >::type* = 0)
Howard Hinnant74279a52010-09-04 23:28:19 +0000208#endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnante4f92722010-05-27 17:06:52 +0000209{
Howard Hinnant72f73582010-08-11 17:04:31 +0000210#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnantb1ad5a82011-06-30 21:18:19 +0000211 throw __nested<typename remove_reference<_Tp>::type>(_VSTD::forward<_Tp>(__t));
Eric Fiselier6003c772016-12-23 23:37:52 +0000212#else
213 ((void)__t);
214 // FIXME: Make this abort.
Howard Hinnant72f73582010-08-11 17:04:31 +0000215#endif
Howard Hinnante4f92722010-05-27 17:06:52 +0000216}
217
218template <class _Tp>
Richard Smithcabd3922012-07-26 02:04:22 +0000219_LIBCPP_NORETURN
Howard Hinnant3b6579a2010-08-22 00:02:43 +0000220void
Howard Hinnant74279a52010-09-04 23:28:19 +0000221#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnant8df96292011-05-26 17:07:32 +0000222throw_with_nested(_Tp&& __t, typename enable_if<
Howard Hinnante4f92722010-05-27 17:06:52 +0000223 !is_class<typename remove_reference<_Tp>::type>::value ||
224 is_base_of<nested_exception, typename remove_reference<_Tp>::type>::value
Eric Fiselierf7394302015-06-13 07:08:02 +0000225 || __libcpp_is_final<typename remove_reference<_Tp>::type>::value
Howard Hinnante4f92722010-05-27 17:06:52 +0000226 >::type* = 0)
Howard Hinnant74279a52010-09-04 23:28:19 +0000227#else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnante4f92722010-05-27 17:06:52 +0000228throw_with_nested (_Tp& __t, typename enable_if<
229 !is_class<_Tp>::value || is_base_of<nested_exception, _Tp>::value
230 >::type* = 0)
Howard Hinnant74279a52010-09-04 23:28:19 +0000231#endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnante4f92722010-05-27 17:06:52 +0000232{
Howard Hinnant72f73582010-08-11 17:04:31 +0000233#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnantb1ad5a82011-06-30 21:18:19 +0000234 throw _VSTD::forward<_Tp>(__t);
Eric Fiselier6003c772016-12-23 23:37:52 +0000235#else
236 ((void)__t);
237 // FIXME: Make this abort
Howard Hinnant72f73582010-08-11 17:04:31 +0000238#endif
Howard Hinnante4f92722010-05-27 17:06:52 +0000239}
240
Howard Hinnantc834c512011-11-29 18:15:50 +0000241template <class _Ep>
Howard Hinnant874ad9a2010-09-21 21:28:23 +0000242inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnante4f92722010-05-27 17:06:52 +0000243void
Howard Hinnantc834c512011-11-29 18:15:50 +0000244rethrow_if_nested(const _Ep& __e, typename enable_if<
245 is_polymorphic<_Ep>::value
Howard Hinnante4f92722010-05-27 17:06:52 +0000246 >::type* = 0)
247{
Marshall Clowe993abe2015-12-14 18:01:56 +0000248 const nested_exception* __nep = dynamic_cast<const nested_exception*>(_VSTD::addressof(__e));
Howard Hinnant3615a192010-05-28 13:35:41 +0000249 if (__nep)
250 __nep->rethrow_nested();
Howard Hinnante4f92722010-05-27 17:06:52 +0000251}
252
Howard Hinnantc834c512011-11-29 18:15:50 +0000253template <class _Ep>
Howard Hinnant874ad9a2010-09-21 21:28:23 +0000254inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnante4f92722010-05-27 17:06:52 +0000255void
Howard Hinnant28b24882011-12-01 20:21:04 +0000256rethrow_if_nested(const _Ep&, typename enable_if<
Howard Hinnantc834c512011-11-29 18:15:50 +0000257 !is_polymorphic<_Ep>::value
Howard Hinnante4f92722010-05-27 17:06:52 +0000258 >::type* = 0)
259{
260}
261
Howard Hinnantc51e1022010-05-11 19:42:16 +0000262} // std
263
Howard Hinnantc51e1022010-05-11 19:42:16 +0000264#endif // _LIBCPP_EXCEPTION