blob: 9999ca096c000ad749f5b91a86d1adec486b2582 [file] [log] [blame]
Howard Hinnantbc8d3f92010-05-11 19:42:161// -*- C++ -*-
2//===-------------------------- exception ---------------------------------===//
3//
Howard Hinnantf5256e12010-05-11 21:36:014// The LLVM Compiler Infrastructure
Howard Hinnantbc8d3f92010-05-11 19:42:165//
Howard Hinnantb64f8b02010-11-16 22:09:026// This file is dual licensed under the MIT and the University of Illinois Open
7// Source Licenses. See LICENSE.TXT for details.
Howard Hinnantbc8d3f92010-05-11 19:42:168//
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 Hinnanted569212011-05-26 18:23:5923 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 Hinnantbc8d3f92010-05-11 19:42:1628};
29
30class bad_exception
31 : public exception
32{
33public:
Howard Hinnanted569212011-05-26 18:23:5934 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 Hinnantbc8d3f92010-05-11 19:42:1639};
40
41typedef void (*unexpected_handler)();
Howard Hinnanted569212011-05-26 18:23:5942unexpected_handler set_unexpected(unexpected_handler f ) noexcept;
43unexpected_handler get_unexpected() noexcept;
44[[noreturn]] void unexpected();
Howard Hinnantbc8d3f92010-05-11 19:42:1645
46typedef void (*terminate_handler)();
Howard Hinnanted569212011-05-26 18:23:5947terminate_handler set_terminate(terminate_handler f ) noexcept;
48terminate_handler get_terminate() noexcept;
49[[noreturn]] void terminate() noexcept;
Howard Hinnantbc8d3f92010-05-11 19:42:1650
Marshall Clow8731c5d2015-06-02 15:33:3851bool uncaught_exception() noexcept;
52int uncaught_exceptions() noexcept; // C++17
Howard Hinnantbc8d3f92010-05-11 19:42:1653
54typedef unspecified exception_ptr;
55
Howard Hinnanted569212011-05-26 18:23:5956exception_ptr current_exception() noexcept;
Howard Hinnantbc8d3f92010-05-11 19:42:1657void rethrow_exception [[noreturn]] (exception_ptr p);
Howard Hinnanted569212011-05-26 18:23:5958template<class E> exception_ptr make_exception_ptr(E e) noexcept;
Howard Hinnantbc8d3f92010-05-11 19:42:1659
60class nested_exception
61{
62public:
Howard Hinnanted569212011-05-26 18:23:5963 nested_exception() noexcept;
64 nested_exception(const nested_exception&) noexcept = default;
65 nested_exception& operator=(const nested_exception&) noexcept = default;
Howard Hinnantbc8d3f92010-05-11 19:42:1666 virtual ~nested_exception() = default;
67
68 // access functions
Howard Hinnanted569212011-05-26 18:23:5969 [[noreturn]] void rethrow_nested() const;
70 exception_ptr nested_ptr() const noexcept;
Howard Hinnantbc8d3f92010-05-11 19:42:1671};
72
Howard Hinnanted569212011-05-26 18:23:5973template <class T> [[noreturn]] void throw_with_nested(T&& t);
Howard Hinnantbc8d3f92010-05-11 19:42:1674template <class E> void rethrow_if_nested(const E& e);
75
76} // std
77
78*/
79
80#include <__config>
81#include <cstddef>
Eric Fiselier81b7f632016-12-03 03:22:1182#include <cstdlib>
Howard Hinnanted2c2912010-05-27 17:06:5283#include <type_traits>
Howard Hinnantbc8d3f92010-05-11 19:42:1684
Eric Fiselier1edf3162017-02-10 08:57:3585#if defined(_LIBCPP_ABI_MICROSOFT)
86#include <vcruntime_exception.h>
87#endif
88
Howard Hinnant08e17472011-10-17 20:05:1089#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Howard Hinnantbc8d3f92010-05-11 19:42:1690#pragma GCC system_header
Howard Hinnant08e17472011-10-17 20:05:1091#endif
Howard Hinnantbc8d3f92010-05-11 19:42:1692
93namespace std // purposefully not using versioning namespace
94{
95
Eric Fiselier1edf3162017-02-10 08:57:3596#if !defined(_LIBCPP_ABI_MICROSOFT)
Howard Hinnantbc8d3f92010-05-11 19:42:1697class _LIBCPP_EXCEPTION_ABI exception
98{
99public:
Howard Hinnanted569212011-05-26 18:23:59100 _LIBCPP_INLINE_VISIBILITY exception() _NOEXCEPT {}
101 virtual ~exception() _NOEXCEPT;
102 virtual const char* what() const _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16103};
104
105class _LIBCPP_EXCEPTION_ABI bad_exception
106 : public exception
107{
108public:
Howard Hinnanted569212011-05-26 18:23:59109 _LIBCPP_INLINE_VISIBILITY bad_exception() _NOEXCEPT {}
110 virtual ~bad_exception() _NOEXCEPT;
111 virtual const char* what() const _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16112};
Eric Fiselier1edf3162017-02-10 08:57:35113#endif // !_LIBCPP_ABI_MICROSOFT
Howard Hinnantbc8d3f92010-05-11 19:42:16114
Eric Fiselier515ba552017-02-17 03:25:08115#if _LIBCPP_STD_VER <= 14 \
116 || defined(_LIBCPP_ENABLE_CXX17_REMOVED_UNEXPECTED_FUNCTIONS) \
117 || defined(_LIBCPP_BUILDING_LIBRARY)
Howard Hinnantbc8d3f92010-05-11 19:42:16118typedef void (*unexpected_handler)();
Howard Hinnant83eade62013-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 Fiselier515ba552017-02-17 03:25:08122#endif
Howard Hinnantbc8d3f92010-05-11 19:42:16123
124typedef void (*terminate_handler)();
Howard Hinnant83eade62013-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 Hinnantbc8d3f92010-05-11 19:42:16128
Howard Hinnant83eade62013-03-06 23:30:19129_LIBCPP_FUNC_VIS bool uncaught_exception() _NOEXCEPT;
Mehdi Amini907c1192017-05-04 17:08:54130_LIBCPP_FUNC_VIS _LIBCPP_AVAILABILITY_UNCAUGHT_EXCEPTIONS int uncaught_exceptions() _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16131
Howard Hinnant83eade62013-03-06 23:30:19132class _LIBCPP_TYPE_VIS exception_ptr;
Howard Hinnantbc8d3f92010-05-11 19:42:16133
Howard Hinnant0f678bd2013-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 Hinnantbc8d3f92010-05-11 19:42:16136
Howard Hinnant83eade62013-03-06 23:30:19137class _LIBCPP_TYPE_VIS exception_ptr
Howard Hinnantbc8d3f92010-05-11 19:42:16138{
139 void* __ptr_;
140public:
Howard Hinnanted569212011-05-26 18:23:59141 _LIBCPP_INLINE_VISIBILITY exception_ptr() _NOEXCEPT : __ptr_() {}
142 _LIBCPP_INLINE_VISIBILITY exception_ptr(nullptr_t) _NOEXCEPT : __ptr_() {}
143 exception_ptr(const exception_ptr&) _NOEXCEPT;
144 exception_ptr& operator=(const exception_ptr&) _NOEXCEPT;
145 ~exception_ptr() _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16146
Howard Hinnant422a53f2010-09-21 21:28:23147 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant77861882012-02-21 21:46:43148 _LIBCPP_EXPLICIT
Howard Hinnanted569212011-05-26 18:23:59149 operator bool() const _NOEXCEPT {return __ptr_ != nullptr;}
Howard Hinnantbc8d3f92010-05-11 19:42:16150
Howard Hinnant422a53f2010-09-21 21:28:23151 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted569212011-05-26 18:23:59152 bool operator==(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnantbc8d3f92010-05-11 19:42:16153 {return __x.__ptr_ == __y.__ptr_;}
Howard Hinnant422a53f2010-09-21 21:28:23154 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted569212011-05-26 18:23:59155 bool operator!=(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnantbc8d3f92010-05-11 19:42:16156 {return !(__x == __y);}
157
Howard Hinnant0f678bd2013-08-12 18:38:34158 friend _LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
159 friend _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
Howard Hinnantbc8d3f92010-05-11 19:42:16160};
161
Howard Hinnant99968442011-11-29 18:15:50162template<class _Ep>
Howard Hinnantbc8d3f92010-05-11 19:42:16163exception_ptr
Howard Hinnant99968442011-11-29 18:15:50164make_exception_ptr(_Ep __e) _NOEXCEPT
Howard Hinnantbc8d3f92010-05-11 19:42:16165{
Howard Hinnantd4444702010-08-11 17:04:31166#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnantbc8d3f92010-05-11 19:42:16167 try
168 {
169 throw __e;
170 }
171 catch (...)
172 {
173 return current_exception();
174 }
Eric Fiselier81b7f632016-12-03 03:22:11175#else
Eric Fiselier0e5ebbc2016-12-23 23:37:52176 ((void)__e);
Eric Fiselier81b7f632016-12-03 03:22:11177 _VSTD::abort();
178#endif
Howard Hinnantbc8d3f92010-05-11 19:42:16179}
180
Howard Hinnanted2c2912010-05-27 17:06:52181// nested_exception
182
183class _LIBCPP_EXCEPTION_ABI nested_exception
184{
185 exception_ptr __ptr_;
186public:
Howard Hinnanted569212011-05-26 18:23:59187 nested_exception() _NOEXCEPT;
188// nested_exception(const nested_exception&) noexcept = default;
189// nested_exception& operator=(const nested_exception&) noexcept = default;
190 virtual ~nested_exception() _NOEXCEPT;
Howard Hinnanted2c2912010-05-27 17:06:52191
192 // access functions
Richard Smith0405cc42012-07-26 02:04:22193 _LIBCPP_NORETURN void rethrow_nested() const;
Howard Hinnanted569212011-05-26 18:23:59194 _LIBCPP_INLINE_VISIBILITY exception_ptr nested_ptr() const _NOEXCEPT {return __ptr_;}
Howard Hinnanted2c2912010-05-27 17:06:52195};
196
197template <class _Tp>
198struct __nested
199 : public _Tp,
200 public nested_exception
201{
Howard Hinnant422a53f2010-09-21 21:28:23202 _LIBCPP_INLINE_VISIBILITY explicit __nested(const _Tp& __t) : _Tp(__t) {}
Howard Hinnanted2c2912010-05-27 17:06:52203};
204
Howard Hinnantd4444702010-08-11 17:04:31205#ifndef _LIBCPP_NO_EXCEPTIONS
Marshall Clow9ac5bc52017-04-13 14:41:45206template <class _Tp, class _Up, bool>
207struct __throw_with_nested;
208
209template <class _Tp, class _Up>
210struct __throw_with_nested<_Tp, _Up, true> {
211 _LIBCPP_NORETURN static inline _LIBCPP_ALWAYS_INLINE void
Eric Fiselier2c4b8af2017-04-19 01:35:58212#ifndef _LIBCPP_CXX03_LANG
Marshall Clow9ac5bc52017-04-13 14:41:45213 __do_throw(_Tp&& __t)
Eric Fiselier2c4b8af2017-04-19 01:35:58214#else
Marshall Clow9ac5bc52017-04-13 14:41:45215 __do_throw (_Tp& __t)
Eric Fiselier2c4b8af2017-04-19 01:35:58216#endif // _LIBCPP_CXX03_LANG
Marshall Clow9ac5bc52017-04-13 14:41:45217 {
218 throw __nested<_Up>(_VSTD::forward<_Tp>(__t));
219 }
220};
221
222template <class _Tp, class _Up>
223struct __throw_with_nested<_Tp, _Up, false> {
224 _LIBCPP_NORETURN static inline _LIBCPP_ALWAYS_INLINE void
Eric Fiselier2c4b8af2017-04-19 01:35:58225#ifndef _LIBCPP_CXX03_LANG
Marshall Clow9ac5bc52017-04-13 14:41:45226 __do_throw(_Tp&& __t)
Eric Fiselier2c4b8af2017-04-19 01:35:58227#else
Marshall Clow9ac5bc52017-04-13 14:41:45228 __do_throw (_Tp& __t)
Eric Fiselier2c4b8af2017-04-19 01:35:58229#endif // _LIBCPP_CXX03_LANG
Marshall Clow9ac5bc52017-04-13 14:41:45230 {
231 throw _VSTD::forward<_Tp>(__t);
232 }
233};
Howard Hinnantd4444702010-08-11 17:04:31234#endif
Howard Hinnanted2c2912010-05-27 17:06:52235
236template <class _Tp>
Richard Smith0405cc42012-07-26 02:04:22237_LIBCPP_NORETURN
Howard Hinnant324bb032010-08-22 00:02:43238void
Eric Fiselier2c4b8af2017-04-19 01:35:58239#ifndef _LIBCPP_CXX03_LANG
Marshall Clow9ac5bc52017-04-13 14:41:45240throw_with_nested(_Tp&& __t)
241#else
242throw_with_nested (_Tp& __t)
Eric Fiselier2c4b8af2017-04-19 01:35:58243#endif // _LIBCPP_CXX03_LANG
Howard Hinnanted2c2912010-05-27 17:06:52244{
Howard Hinnantd4444702010-08-11 17:04:31245#ifndef _LIBCPP_NO_EXCEPTIONS
Marshall Clow64035712017-04-13 16:57:42246 typedef typename decay<_Tp>::type _Up;
247 static_assert( is_copy_constructible<_Up>::value, "type thrown must be CopyConstructible");
Marshall Clow9ac5bc52017-04-13 14:41:45248 __throw_with_nested<_Tp, _Up,
249 is_class<_Up>::value &&
250 !is_base_of<nested_exception, _Up>::value &&
251 !__libcpp_is_final<_Up>::value>::
252 __do_throw(_VSTD::forward<_Tp>(__t));
Eric Fiselier0e5ebbc2016-12-23 23:37:52253#else
254 ((void)__t);
255 // FIXME: Make this abort
Howard Hinnantd4444702010-08-11 17:04:31256#endif
Howard Hinnanted2c2912010-05-27 17:06:52257}
258
Marshall Clowabba6852017-03-14 17:08:47259template <class _From, class _To>
260struct __can_dynamic_cast : public _LIBCPP_BOOL_CONSTANT(
261 is_polymorphic<_From>::value &&
262 (!is_base_of<_To, _From>::value ||
263 is_convertible<const _From*, const _To*>::value)) {};
264
Howard Hinnant99968442011-11-29 18:15:50265template <class _Ep>
Howard Hinnant422a53f2010-09-21 21:28:23266inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted2c2912010-05-27 17:06:52267void
Marshall Clowabba6852017-03-14 17:08:47268rethrow_if_nested(const _Ep& __e,
269 typename enable_if< __can_dynamic_cast<_Ep, nested_exception>::value>::type* = 0)
Howard Hinnanted2c2912010-05-27 17:06:52270{
Marshall Clowb6621c52015-12-14 18:01:56271 const nested_exception* __nep = dynamic_cast<const nested_exception*>(_VSTD::addressof(__e));
Howard Hinnant6bb9f582010-05-28 13:35:41272 if (__nep)
273 __nep->rethrow_nested();
Howard Hinnanted2c2912010-05-27 17:06:52274}
275
Howard Hinnant99968442011-11-29 18:15:50276template <class _Ep>
Howard Hinnant422a53f2010-09-21 21:28:23277inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted2c2912010-05-27 17:06:52278void
Marshall Clowabba6852017-03-14 17:08:47279rethrow_if_nested(const _Ep&,
280 typename enable_if<!__can_dynamic_cast<_Ep, nested_exception>::value>::type* = 0)
Howard Hinnanted2c2912010-05-27 17:06:52281{
282}
283
Howard Hinnantbc8d3f92010-05-11 19:42:16284} // std
285
Howard Hinnantbc8d3f92010-05-11 19:42:16286#endif // _LIBCPP_EXCEPTION