| 1 | // Exception Handling support header (exception_ptr class) for -*- C++ -*- |
|---|---|
| 2 | |
| 3 | // Copyright (C) 2008-2017 Free Software Foundation, Inc. |
| 4 | // |
| 5 | // This file is part of GCC. |
| 6 | // |
| 7 | // GCC is free software; you can redistribute it and/or modify |
| 8 | // it under the terms of the GNU General Public License as published by |
| 9 | // the Free Software Foundation; either version 3, or (at your option) |
| 10 | // any later version. |
| 11 | // |
| 12 | // GCC is distributed in the hope that it will be useful, |
| 13 | // but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 14 | // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 15 | // GNU General Public License for more details. |
| 16 | // |
| 17 | // Under Section 7 of GPL version 3, you are granted additional |
| 18 | // permissions described in the GCC Runtime Library Exception, version |
| 19 | // 3.1, as published by the Free Software Foundation. |
| 20 | |
| 21 | // You should have received a copy of the GNU General Public License and |
| 22 | // a copy of the GCC Runtime Library Exception along with this program; |
| 23 | // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see |
| 24 | // <http://www.gnu.org/licenses/>. |
| 25 | |
| 26 | /** @file bits/exception_ptr.h |
| 27 | * This is an internal header file, included by other library headers. |
| 28 | * Do not attempt to use it directly. @headername{exception} |
| 29 | */ |
| 30 | |
| 31 | #ifndef _EXCEPTION_PTR_H |
| 32 | #define _EXCEPTION_PTR_H |
| 33 | |
| 34 | #pragma GCC visibility push(default) |
| 35 | |
| 36 | #include <bits/c++config.h> |
| 37 | #include <bits/exception_defines.h> |
| 38 | #include <bits/cxxabi_init_exception.h> |
| 39 | #include <typeinfo> |
| 40 | #include <new> |
| 41 | |
| 42 | extern "C++" { |
| 43 | |
| 44 | namespace std |
| 45 | { |
| 46 | class type_info; |
| 47 | |
| 48 | /** |
| 49 | * @addtogroup exceptions |
| 50 | * @{ |
| 51 | */ |
| 52 | namespace __exception_ptr |
| 53 | { |
| 54 | class exception_ptr; |
| 55 | } |
| 56 | |
| 57 | using __exception_ptr::exception_ptr; |
| 58 | |
| 59 | /** Obtain an exception_ptr to the currently handled exception. If there |
| 60 | * is none, or the currently handled exception is foreign, return the null |
| 61 | * value. |
| 62 | */ |
| 63 | exception_ptr current_exception() _GLIBCXX_USE_NOEXCEPT; |
| 64 | |
| 65 | template<typename _Ex> |
| 66 | exception_ptr make_exception_ptr(_Ex) _GLIBCXX_USE_NOEXCEPT; |
| 67 | |
| 68 | /// Throw the object pointed to by the exception_ptr. |
| 69 | void rethrow_exception(exception_ptr) __attribute__ ((__noreturn__)); |
| 70 | |
| 71 | namespace __exception_ptr |
| 72 | { |
| 73 | using std::rethrow_exception; |
| 74 | |
| 75 | /** |
| 76 | * @brief An opaque pointer to an arbitrary exception. |
| 77 | * @ingroup exceptions |
| 78 | */ |
| 79 | class exception_ptr |
| 80 | { |
| 81 | void* _M_exception_object; |
| 82 | |
| 83 | explicit exception_ptr(void* __e) _GLIBCXX_USE_NOEXCEPT; |
| 84 | |
| 85 | void _M_addref() _GLIBCXX_USE_NOEXCEPT; |
| 86 | void _M_release() _GLIBCXX_USE_NOEXCEPT; |
| 87 | |
| 88 | void *_M_get() const _GLIBCXX_NOEXCEPT __attribute__ ((__pure__)); |
| 89 | |
| 90 | friend exception_ptr std::current_exception() _GLIBCXX_USE_NOEXCEPT; |
| 91 | friend void std::rethrow_exception(exception_ptr); |
| 92 | template<typename _Ex> |
| 93 | friend exception_ptr std::make_exception_ptr(_Ex) _GLIBCXX_USE_NOEXCEPT; |
| 94 | |
| 95 | public: |
| 96 | exception_ptr() _GLIBCXX_USE_NOEXCEPT; |
| 97 | |
| 98 | exception_ptr(const exception_ptr&) _GLIBCXX_USE_NOEXCEPT; |
| 99 | |
| 100 | #if __cplusplus >= 201103L |
| 101 | exception_ptr(nullptr_t) noexcept |
| 102 | : _M_exception_object(0) |
| 103 | { } |
| 104 | |
| 105 | exception_ptr(exception_ptr&& __o) noexcept |
| 106 | : _M_exception_object(__o._M_exception_object) |
| 107 | { __o._M_exception_object = 0; } |
| 108 | #endif |
| 109 | |
| 110 | #if (__cplusplus < 201103L) || defined (_GLIBCXX_EH_PTR_COMPAT) |
| 111 | typedef void (exception_ptr::*__safe_bool)(); |
| 112 | |
| 113 | // For construction from nullptr or 0. |
| 114 | exception_ptr(__safe_bool) _GLIBCXX_USE_NOEXCEPT; |
| 115 | #endif |
| 116 | |
| 117 | exception_ptr& |
| 118 | operator=(const exception_ptr&) _GLIBCXX_USE_NOEXCEPT; |
| 119 | |
| 120 | #if __cplusplus >= 201103L |
| 121 | exception_ptr& |
| 122 | operator=(exception_ptr&& __o) noexcept |
| 123 | { |
| 124 | exception_ptr(static_cast<exception_ptr&&>(__o)).swap(*this); |
| 125 | return *this; |
| 126 | } |
| 127 | #endif |
| 128 | |
| 129 | ~exception_ptr() _GLIBCXX_USE_NOEXCEPT; |
| 130 | |
| 131 | void |
| 132 | swap(exception_ptr&) _GLIBCXX_USE_NOEXCEPT; |
| 133 | |
| 134 | #ifdef _GLIBCXX_EH_PTR_COMPAT |
| 135 | // Retained for compatibility with CXXABI_1.3. |
| 136 | void _M_safe_bool_dummy() _GLIBCXX_USE_NOEXCEPT |
| 137 | __attribute__ ((__const__)); |
| 138 | bool operator!() const _GLIBCXX_USE_NOEXCEPT |
| 139 | __attribute__ ((__pure__)); |
| 140 | operator __safe_bool() const _GLIBCXX_USE_NOEXCEPT; |
| 141 | #endif |
| 142 | |
| 143 | #if __cplusplus >= 201103L |
| 144 | explicit operator bool() const |
| 145 | { return _M_exception_object; } |
| 146 | #endif |
| 147 | |
| 148 | friend bool |
| 149 | operator==(const exception_ptr&, const exception_ptr&) |
| 150 | _GLIBCXX_USE_NOEXCEPT __attribute__ ((__pure__)); |
| 151 | |
| 152 | const class std::type_info* |
| 153 | __cxa_exception_type() const _GLIBCXX_USE_NOEXCEPT |
| 154 | __attribute__ ((__pure__)); |
| 155 | }; |
| 156 | |
| 157 | bool |
| 158 | operator==(const exception_ptr&, const exception_ptr&) |
| 159 | _GLIBCXX_USE_NOEXCEPT __attribute__ ((__pure__)); |
| 160 | |
| 161 | bool |
| 162 | operator!=(const exception_ptr&, const exception_ptr&) |
| 163 | _GLIBCXX_USE_NOEXCEPT __attribute__ ((__pure__)); |
| 164 | |
| 165 | inline void |
| 166 | swap(exception_ptr& __lhs, exception_ptr& __rhs) |
| 167 | { __lhs.swap(__rhs); } |
| 168 | |
| 169 | template<typename _Ex> |
| 170 | inline void |
| 171 | __dest_thunk(void* __x) |
| 172 | { static_cast<_Ex*>(__x)->~_Ex(); } |
| 173 | |
| 174 | } // namespace __exception_ptr |
| 175 | |
| 176 | /// Obtain an exception_ptr pointing to a copy of the supplied object. |
| 177 | template<typename _Ex> |
| 178 | exception_ptr |
| 179 | make_exception_ptr(_Ex __ex) _GLIBCXX_USE_NOEXCEPT |
| 180 | { |
| 181 | #if __cpp_exceptions && __cpp_rtti && !_GLIBCXX_HAVE_CDTOR_CALLABI |
| 182 | void* __e = __cxxabiv1::__cxa_allocate_exception(sizeof(_Ex)); |
| 183 | (void) __cxxabiv1::__cxa_init_primary_exception( |
| 184 | __e, const_cast<std::type_info*>(&typeid(__ex)), |
| 185 | __exception_ptr::__dest_thunk<_Ex>); |
| 186 | try |
| 187 | { |
| 188 | ::new (__e) _Ex(__ex); |
| 189 | return exception_ptr(__e); |
| 190 | } |
| 191 | catch(...) |
| 192 | { |
| 193 | __cxxabiv1::__cxa_free_exception(__e); |
| 194 | return current_exception(); |
| 195 | } |
| 196 | #elif __cpp_exceptions |
| 197 | try |
| 198 | { |
| 199 | throw __ex; |
| 200 | } |
| 201 | catch(...) |
| 202 | { |
| 203 | return current_exception(); |
| 204 | } |
| 205 | #else // no RTTI and no exceptions |
| 206 | return exception_ptr(); |
| 207 | #endif |
| 208 | } |
| 209 | |
| 210 | // _GLIBCXX_RESOLVE_LIB_DEFECTS |
| 211 | // 1130. copy_exception name misleading |
| 212 | /// Obtain an exception_ptr pointing to a copy of the supplied object. |
| 213 | /// This function is deprecated, use std::make_exception_ptr instead. |
| 214 | template<typename _Ex> |
| 215 | exception_ptr |
| 216 | copy_exception(_Ex __ex) _GLIBCXX_USE_NOEXCEPT _GLIBCXX_DEPRECATED; |
| 217 | |
| 218 | template<typename _Ex> |
| 219 | exception_ptr |
| 220 | copy_exception(_Ex __ex) _GLIBCXX_USE_NOEXCEPT |
| 221 | { return std::make_exception_ptr<_Ex>(__ex); } |
| 222 | |
| 223 | // @} group exceptions |
| 224 | } // namespace std |
| 225 | |
| 226 | } // extern "C++" |
| 227 | |
| 228 | #pragma GCC visibility pop |
| 229 | |
| 230 | #endif |
| 231 |