blob: 686e4ecd05783a9fdb52f689178abaa7cb79bc68 [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>
Howard Hinnanted2c2912010-05-27 17:06:5282#include <type_traits>
Howard Hinnantbc8d3f92010-05-11 19:42:1683
Howard Hinnant08e17472011-10-17 20:05:1084#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Howard Hinnantbc8d3f92010-05-11 19:42:1685#pragma GCC system_header
Howard Hinnant08e17472011-10-17 20:05:1086#endif
Howard Hinnantbc8d3f92010-05-11 19:42:1687
88namespace std // purposefully not using versioning namespace
89{
90
91class _LIBCPP_EXCEPTION_ABI exception
92{
93public:
Howard Hinnanted569212011-05-26 18:23:5994 _LIBCPP_INLINE_VISIBILITY exception() _NOEXCEPT {}
95 virtual ~exception() _NOEXCEPT;
96 virtual const char* what() const _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:1697};
98
99class _LIBCPP_EXCEPTION_ABI bad_exception
100 : public exception
101{
102public:
Howard Hinnanted569212011-05-26 18:23:59103 _LIBCPP_INLINE_VISIBILITY bad_exception() _NOEXCEPT {}
104 virtual ~bad_exception() _NOEXCEPT;
105 virtual const char* what() const _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16106};
107
108typedef void (*unexpected_handler)();
Howard Hinnant83eade62013-03-06 23:30:19109_LIBCPP_FUNC_VIS unexpected_handler set_unexpected(unexpected_handler) _NOEXCEPT;
110_LIBCPP_FUNC_VIS unexpected_handler get_unexpected() _NOEXCEPT;
111_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void unexpected();
Howard Hinnantbc8d3f92010-05-11 19:42:16112
113typedef void (*terminate_handler)();
Howard Hinnant83eade62013-03-06 23:30:19114_LIBCPP_FUNC_VIS terminate_handler set_terminate(terminate_handler) _NOEXCEPT;
115_LIBCPP_FUNC_VIS terminate_handler get_terminate() _NOEXCEPT;
116_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void terminate() _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16117
Howard Hinnant83eade62013-03-06 23:30:19118_LIBCPP_FUNC_VIS bool uncaught_exception() _NOEXCEPT;
Marshall Clow8731c5d2015-06-02 15:33:38119_LIBCPP_FUNC_VIS int uncaught_exceptions() _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16120
Howard Hinnant83eade62013-03-06 23:30:19121class _LIBCPP_TYPE_VIS exception_ptr;
Howard Hinnantbc8d3f92010-05-11 19:42:16122
Howard Hinnant0f678bd2013-08-12 18:38:34123_LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
124_LIBCPP_NORETURN _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
Howard Hinnantbc8d3f92010-05-11 19:42:16125
Howard Hinnant83eade62013-03-06 23:30:19126class _LIBCPP_TYPE_VIS exception_ptr
Howard Hinnantbc8d3f92010-05-11 19:42:16127{
128 void* __ptr_;
129public:
Howard Hinnanted569212011-05-26 18:23:59130 _LIBCPP_INLINE_VISIBILITY exception_ptr() _NOEXCEPT : __ptr_() {}
131 _LIBCPP_INLINE_VISIBILITY exception_ptr(nullptr_t) _NOEXCEPT : __ptr_() {}
132 exception_ptr(const exception_ptr&) _NOEXCEPT;
133 exception_ptr& operator=(const exception_ptr&) _NOEXCEPT;
134 ~exception_ptr() _NOEXCEPT;
Howard Hinnantbc8d3f92010-05-11 19:42:16135
Howard Hinnant422a53f2010-09-21 21:28:23136 _LIBCPP_INLINE_VISIBILITY
Howard Hinnant77861882012-02-21 21:46:43137 _LIBCPP_EXPLICIT
Howard Hinnanted569212011-05-26 18:23:59138 operator bool() const _NOEXCEPT {return __ptr_ != nullptr;}
Howard Hinnantbc8d3f92010-05-11 19:42:16139
Howard Hinnant422a53f2010-09-21 21:28:23140 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted569212011-05-26 18:23:59141 bool operator==(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnantbc8d3f92010-05-11 19:42:16142 {return __x.__ptr_ == __y.__ptr_;}
Howard Hinnant422a53f2010-09-21 21:28:23143 friend _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted569212011-05-26 18:23:59144 bool operator!=(const exception_ptr& __x, const exception_ptr& __y) _NOEXCEPT
Howard Hinnantbc8d3f92010-05-11 19:42:16145 {return !(__x == __y);}
146
Howard Hinnant0f678bd2013-08-12 18:38:34147 friend _LIBCPP_FUNC_VIS exception_ptr current_exception() _NOEXCEPT;
148 friend _LIBCPP_FUNC_VIS void rethrow_exception(exception_ptr);
Howard Hinnantbc8d3f92010-05-11 19:42:16149};
150
Howard Hinnant99968442011-11-29 18:15:50151template<class _Ep>
Howard Hinnantbc8d3f92010-05-11 19:42:16152exception_ptr
Howard Hinnant99968442011-11-29 18:15:50153make_exception_ptr(_Ep __e) _NOEXCEPT
Howard Hinnantbc8d3f92010-05-11 19:42:16154{
Howard Hinnantd4444702010-08-11 17:04:31155#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnantbc8d3f92010-05-11 19:42:16156 try
157 {
158 throw __e;
159 }
160 catch (...)
161 {
162 return current_exception();
163 }
Howard Hinnant324bb032010-08-22 00:02:43164#endif // _LIBCPP_NO_EXCEPTIONS
Howard Hinnantbc8d3f92010-05-11 19:42:16165}
166
Howard Hinnanted2c2912010-05-27 17:06:52167// nested_exception
168
169class _LIBCPP_EXCEPTION_ABI nested_exception
170{
171 exception_ptr __ptr_;
172public:
Howard Hinnanted569212011-05-26 18:23:59173 nested_exception() _NOEXCEPT;
174// nested_exception(const nested_exception&) noexcept = default;
175// nested_exception& operator=(const nested_exception&) noexcept = default;
176 virtual ~nested_exception() _NOEXCEPT;
Howard Hinnanted2c2912010-05-27 17:06:52177
178 // access functions
Richard Smith0405cc42012-07-26 02:04:22179 _LIBCPP_NORETURN void rethrow_nested() const;
Howard Hinnanted569212011-05-26 18:23:59180 _LIBCPP_INLINE_VISIBILITY exception_ptr nested_ptr() const _NOEXCEPT {return __ptr_;}
Howard Hinnanted2c2912010-05-27 17:06:52181};
182
183template <class _Tp>
184struct __nested
185 : public _Tp,
186 public nested_exception
187{
Howard Hinnant422a53f2010-09-21 21:28:23188 _LIBCPP_INLINE_VISIBILITY explicit __nested(const _Tp& __t) : _Tp(__t) {}
Howard Hinnanted2c2912010-05-27 17:06:52189};
190
191template <class _Tp>
Richard Smith0405cc42012-07-26 02:04:22192_LIBCPP_NORETURN
Howard Hinnant324bb032010-08-22 00:02:43193void
Howard Hinnant73d21a42010-09-04 23:28:19194#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnant4b7a43d2011-05-26 17:07:32195throw_with_nested(_Tp&& __t, typename enable_if<
Howard Hinnanted2c2912010-05-27 17:06:52196 is_class<typename remove_reference<_Tp>::type>::value &&
197 !is_base_of<nested_exception, typename remove_reference<_Tp>::type>::value
Eric Fiselier3a0e4302015-06-13 07:08:02198 && !__libcpp_is_final<typename remove_reference<_Tp>::type>::value
Howard Hinnanted2c2912010-05-27 17:06:52199 >::type* = 0)
Howard Hinnant73d21a42010-09-04 23:28:19200#else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnanted2c2912010-05-27 17:06:52201throw_with_nested (_Tp& __t, typename enable_if<
202 is_class<_Tp>::value && !is_base_of<nested_exception, _Tp>::value
203 >::type* = 0)
Howard Hinnant73d21a42010-09-04 23:28:19204#endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnanted2c2912010-05-27 17:06:52205{
Howard Hinnantd4444702010-08-11 17:04:31206#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnant0949eed2011-06-30 21:18:19207 throw __nested<typename remove_reference<_Tp>::type>(_VSTD::forward<_Tp>(__t));
Howard Hinnantd4444702010-08-11 17:04:31208#endif
Howard Hinnanted2c2912010-05-27 17:06:52209}
210
211template <class _Tp>
Richard Smith0405cc42012-07-26 02:04:22212_LIBCPP_NORETURN
Howard Hinnant324bb032010-08-22 00:02:43213void
Howard Hinnant73d21a42010-09-04 23:28:19214#ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnant4b7a43d2011-05-26 17:07:32215throw_with_nested(_Tp&& __t, typename enable_if<
Howard Hinnanted2c2912010-05-27 17:06:52216 !is_class<typename remove_reference<_Tp>::type>::value ||
217 is_base_of<nested_exception, typename remove_reference<_Tp>::type>::value
Eric Fiselier3a0e4302015-06-13 07:08:02218 || __libcpp_is_final<typename remove_reference<_Tp>::type>::value
Howard Hinnanted2c2912010-05-27 17:06:52219 >::type* = 0)
Howard Hinnant73d21a42010-09-04 23:28:19220#else // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnanted2c2912010-05-27 17:06:52221throw_with_nested (_Tp& __t, typename enable_if<
222 !is_class<_Tp>::value || is_base_of<nested_exception, _Tp>::value
223 >::type* = 0)
Howard Hinnant73d21a42010-09-04 23:28:19224#endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
Howard Hinnanted2c2912010-05-27 17:06:52225{
Howard Hinnantd4444702010-08-11 17:04:31226#ifndef _LIBCPP_NO_EXCEPTIONS
Howard Hinnant0949eed2011-06-30 21:18:19227 throw _VSTD::forward<_Tp>(__t);
Howard Hinnantd4444702010-08-11 17:04:31228#endif
Howard Hinnanted2c2912010-05-27 17:06:52229}
230
Howard Hinnant99968442011-11-29 18:15:50231template <class _Ep>
Howard Hinnant422a53f2010-09-21 21:28:23232inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted2c2912010-05-27 17:06:52233void
Howard Hinnant99968442011-11-29 18:15:50234rethrow_if_nested(const _Ep& __e, typename enable_if<
235 is_polymorphic<_Ep>::value
Howard Hinnanted2c2912010-05-27 17:06:52236 >::type* = 0)
237{
Marshall Clowb6621c52015-12-14 18:01:56238 const nested_exception* __nep = dynamic_cast<const nested_exception*>(_VSTD::addressof(__e));
Howard Hinnant6bb9f582010-05-28 13:35:41239 if (__nep)
240 __nep->rethrow_nested();
Howard Hinnanted2c2912010-05-27 17:06:52241}
242
Howard Hinnant99968442011-11-29 18:15:50243template <class _Ep>
Howard Hinnant422a53f2010-09-21 21:28:23244inline _LIBCPP_INLINE_VISIBILITY
Howard Hinnanted2c2912010-05-27 17:06:52245void
Howard Hinnantec3773c2011-12-01 20:21:04246rethrow_if_nested(const _Ep&, typename enable_if<
Howard Hinnant99968442011-11-29 18:15:50247 !is_polymorphic<_Ep>::value
Howard Hinnanted2c2912010-05-27 17:06:52248 >::type* = 0)
249{
250}
251
Howard Hinnantbc8d3f92010-05-11 19:42:16252} // std
253
254#endif // _LIBCPP_EXCEPTION