1// Function-Based Exception Support -*- C++ -*-
2
3// Copyright (C) 2001-2024 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
42namespace 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__,__cold__));
61
62 void
63 __throw_bad_typeid(void) __attribute__((__noreturn__,__cold__));
64
65 // Helpers for exception objects in <stdexcept>
66 void
67 __throw_logic_error(const char*) __attribute__((__noreturn__,__cold__));
68
69 void
70 __throw_domain_error(const char*) __attribute__((__noreturn__,__cold__));
71
72 void
73 __throw_invalid_argument(const char*) __attribute__((__noreturn__,__cold__));
74
75 void
76 __throw_length_error(const char*) __attribute__((__noreturn__,__cold__));
77
78 void
79 __throw_out_of_range(const char*) __attribute__((__noreturn__,__cold__));
80
81 void
82 __throw_out_of_range_fmt(const char*, ...) __attribute__((__noreturn__,__cold__))
83 __attribute__((__format__(__gnu_printf__, 1, 2)));
84
85 void
86 __throw_runtime_error(const char*) __attribute__((__noreturn__,__cold__));
87
88 void
89 __throw_range_error(const char*) __attribute__((__noreturn__,__cold__));
90
91 void
92 __throw_overflow_error(const char*) __attribute__((__noreturn__,__cold__));
93
94 void
95 __throw_underflow_error(const char*) __attribute__((__noreturn__,__cold__));
96
97 // Helpers for exception objects in <ios>
98 void
99 __throw_ios_failure(const char*) __attribute__((__noreturn__,__cold__));
100
101 void
102 __throw_ios_failure(const char*, int) __attribute__((__noreturn__,__cold__));
103
104 // Helpers for exception objects in <system_error>
105 void
106 __throw_system_error(int) __attribute__((__noreturn__,__cold__));
107
108 // Helpers for exception objects in <future>
109 void
110 __throw_future_error(int) __attribute__((__noreturn__,__cold__));
111
112 // Helpers for exception objects in <functional>
113 void
114 __throw_bad_function_call() __attribute__((__noreturn__,__cold__));
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
144