libstdc++-v3/include/bits/functexcept.h

   1 // Function-Based Exception Support -*- C++ -*-
   2
   3 // Copyright (C) 2001-2023 Free Software Foundation, Inc.
   4 //
   5 // This file is part of the GNU ISO C++ Library.  This library is free
   6 // software; you can redistribute it and/or modify it under the
   7 // terms of the GNU General Public License as published by the
   8 // Free Software Foundation; either version 3, or (at your option)
   9 // any later version.
  10
  11 // This library is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 // GNU General Public License for more details.
  15
  16 // Under Section 7 of GPL version 3, you are granted additional
  17 // permissions described in the GCC Runtime Library Exception, version
  18 // 3.1, as published by the Free Software Foundation.
  19
  20 // You should have received a copy of the GNU General Public License and
  21 // a copy of the GCC Runtime Library Exception along with this program;
  22 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
  23 // <http://www.gnu.org/licenses/>.
  24
  25 /** @file bits/functexcept.h
  26  *  This is an internal header file, included by other library headers.
  27  *  Do not attempt to use it directly. @headername{exception}
  28  *
  29  *  This header provides support for -fno-exceptions.
  30  */
  31
  32 //
  33 // ISO C++ 14882: 19.1  Exception classes
  34 //
  35
  36 #ifndef _FUNCTEXCEPT_H
  37 #define _FUNCTEXCEPT_H 1
  38
  39 #include <bits/c++config.h>
  40 #include <bits/exception_defines.h>
  41
  42 namespace std _GLIBCXX_VISIBILITY(default)
  43 {
  44 _GLIBCXX_BEGIN_NAMESPACE_VERSION
  45
  46 #if _GLIBCXX_HOSTED
  47   // Helper for exception objects in <except>
  48   void
  49   __throw_bad_exception(void) __attribute__((__noreturn__));
  50
  51   // Helper for exception objects in <new>
  52   void
  53   __throw_bad_alloc(void) __attribute__((__noreturn__));
  54
  55   void
  56   __throw_bad_array_new_length(void) __attribute__((__noreturn__));
  57
  58   // Helper for exception objects in <typeinfo>
  59   void
  60   __throw_bad_cast(void) __attribute__((__noreturn__));
  61
  62   void
  63   __throw_bad_typeid(void) __attribute__((__noreturn__));
  64
  65   // Helpers for exception objects in <stdexcept>
  66   void
  67   __throw_logic_error(const char*) __attribute__((__noreturn__));
  68
  69   void
  70   __throw_domain_error(const char*) __attribute__((__noreturn__));
  71
  72   void
  73   __throw_invalid_argument(const char*) __attribute__((__noreturn__));
  74
  75   void
  76   __throw_length_error(const char*) __attribute__((__noreturn__));
  77
  78   void
  79   __throw_out_of_range(const char*) __attribute__((__noreturn__));
  80
  81   void
  82   __throw_out_of_range_fmt(const char*, ...) __attribute__((__noreturn__))
  83     __attribute__((__format__(__gnu_printf__, 1, 2)));
  84
  85   void
  86   __throw_runtime_error(const char*) __attribute__((__noreturn__));
  87
  88   void
  89   __throw_range_error(const char*) __attribute__((__noreturn__));
  90
  91   void
  92   __throw_overflow_error(const char*) __attribute__((__noreturn__));
  93
  94   void
  95   __throw_underflow_error(const char*) __attribute__((__noreturn__));
  96
  97   // Helpers for exception objects in <ios>
  98   void
  99   __throw_ios_failure(const char*) __attribute__((__noreturn__));
 100
 101   void
 102   __throw_ios_failure(const char*, int) __attribute__((__noreturn__));
 103
 104   // Helpers for exception objects in <system_error>
 105   void
 106   __throw_system_error(int) __attribute__((__noreturn__));
 107
 108   // Helpers for exception objects in <future>
 109   void
 110   __throw_future_error(int) __attribute__((__noreturn__));
 111
 112   // Helpers for exception objects in <functional>
 113   void
 114   __throw_bad_function_call() __attribute__((__noreturn__));
 115
 116 #else // ! HOSTED
 117
 118   __attribute__((__noreturn__)) inline void
 119   __throw_invalid_argument(const char*)
 120   { std::__terminate(); }
 121
 122   __attribute__((__noreturn__)) inline void
 123   __throw_out_of_range(const char*)
 124   { std::__terminate(); }
 125
 126   __attribute__((__noreturn__)) inline void
 127   __throw_out_of_range_fmt(const char*, ...)
 128   { std::__terminate(); }
 129
 130   __attribute__((__noreturn__)) inline void
 131   __throw_runtime_error(const char*)
 132   { std::__terminate(); }
 133
 134   __attribute__((__noreturn__)) inline void
 135   __throw_overflow_error(const char*)
 136   { std::__terminate(); }
 137
 138 #endif // HOSTED
 139
 140 _GLIBCXX_END_NAMESPACE_VERSION
 141 } // namespace
 142
 143 #endif