1// -*- C++ -*- forwarding header.
2
3// Copyright (C) 1997-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 include/cstdlib
26 * This is a Standard C++ Library file. You should @c \#include this file
27 * in your programs, rather than any of the @a *.h implementation files.
28 *
29 * This is the C++ version of the Standard C Library header @c stdlib.h,
30 * and its contents are (mostly) the same as that header, but are all
31 * contained in the namespace @c std (except for names which are defined
32 * as macros in C).
33 */
34
35//
36// ISO C++ 14882: 20.4.6 C library
37//
38
39#pragma GCC system_header
40
41#include <bits/c++config.h>
42
43#ifndef _GLIBCXX_CSTDLIB
44#define _GLIBCXX_CSTDLIB 1
45
46#if !_GLIBCXX_HOSTED
47// The C standard does not require a freestanding implementation to
48// provide <stdlib.h>. However, the C++ standard does still require
49// <cstdlib> -- but only the functionality mentioned in
50// [lib.support.start.term].
51
52#define EXIT_SUCCESS 0
53#define EXIT_FAILURE 1
54#define NULL __null
55
56namespace std
57{
58 extern "C" void abort(void) _GLIBCXX_NOTHROW _GLIBCXX_NORETURN;
59 extern "C" int atexit(void (*)(void)) _GLIBCXX_NOTHROW;
60 extern "C" void exit(int) _GLIBCXX_NOTHROW _GLIBCXX_NORETURN;
61#if __cplusplus >= 201103L
62# ifdef _GLIBCXX_HAVE_AT_QUICK_EXIT
63 extern "C" int at_quick_exit(void (*)(void)) _GLIBCXX_NOTHROW;
64# endif
65# ifdef _GLIBCXX_HAVE_QUICK_EXIT
66 extern "C" void quick_exit(int) _GLIBCXX_NOTHROW _GLIBCXX_NORETURN;
67# endif
68#if _GLIBCXX_USE_C99_STDLIB
69 extern "C" void _Exit(int) _GLIBCXX_NOTHROW _GLIBCXX_NORETURN;
70#endif
71#endif
72} // namespace std
73
74#else
75
76// Need to ensure this finds the C library's <stdlib.h> not a libstdc++
77// wrapper that might already be installed later in the include search path.
78#define _GLIBCXX_INCLUDE_NEXT_C_HEADERS
79#include_next <stdlib.h>
80#undef _GLIBCXX_INCLUDE_NEXT_C_HEADERS
81#include <bits/std_abs.h>
82
83// Get rid of those macros defined in <stdlib.h> in lieu of real functions.
84#undef abort
85#if __cplusplus >= 201703L && defined(_GLIBCXX_HAVE_ALIGNED_ALLOC)
86# undef aligned_alloc
87#endif
88#undef atexit
89#if __cplusplus >= 201103L
90# ifdef _GLIBCXX_HAVE_AT_QUICK_EXIT
91# undef at_quick_exit
92# endif
93#endif
94#undef atof
95#undef atoi
96#undef atol
97#undef bsearch
98#undef calloc
99#undef div
100#undef exit
101#undef free
102#undef getenv
103#undef labs
104#undef ldiv
105#undef malloc
106#undef mblen
107#undef mbstowcs
108#undef mbtowc
109#undef qsort
110#if __cplusplus >= 201103L
111# ifdef _GLIBCXX_HAVE_QUICK_EXIT
112# undef quick_exit
113# endif
114#endif
115#undef rand
116#undef realloc
117#undef srand
118#undef strtod
119#undef strtol
120#undef strtoul
121#undef system
122#undef wcstombs
123#undef wctomb
124
125extern "C++"
126{
127namespace std _GLIBCXX_VISIBILITY(default)
128{
129_GLIBCXX_BEGIN_NAMESPACE_VERSION
130
131 using ::div_t;
132 using ::ldiv_t;
133
134 using ::abort;
135#if __cplusplus >= 201703L && defined(_GLIBCXX_HAVE_ALIGNED_ALLOC)
136 using ::aligned_alloc;
137#endif
138 using ::atexit;
139#if __cplusplus >= 201103L
140# ifdef _GLIBCXX_HAVE_AT_QUICK_EXIT
141 using ::at_quick_exit;
142# endif
143#endif
144 using ::atof;
145 using ::atoi;
146 using ::atol;
147 using ::bsearch;
148 using ::calloc;
149 using ::div;
150 using ::exit;
151 using ::free;
152 using ::getenv;
153 using ::labs;
154 using ::ldiv;
155 using ::malloc;
156#ifdef _GLIBCXX_HAVE_MBSTATE_T
157 using ::mblen;
158 using ::mbstowcs;
159 using ::mbtowc;
160#endif // _GLIBCXX_HAVE_MBSTATE_T
161 using ::qsort;
162#if __cplusplus >= 201103L
163# ifdef _GLIBCXX_HAVE_QUICK_EXIT
164 using ::quick_exit;
165# endif
166#endif
167 using ::rand;
168 using ::realloc;
169 using ::srand;
170 using ::strtod;
171 using ::strtol;
172 using ::strtoul;
173 using ::system;
174#ifdef _GLIBCXX_USE_WCHAR_T
175 using ::wcstombs;
176 using ::wctomb;
177#endif // _GLIBCXX_USE_WCHAR_T
178
179#ifndef __CORRECT_ISO_CPP_STDLIB_H_PROTO
180 inline ldiv_t
181 div(long __i, long __j) _GLIBCXX_NOTHROW { return ldiv(numer: __i, denom: __j); }
182#endif
183
184
185_GLIBCXX_END_NAMESPACE_VERSION
186} // namespace
187
188#if _GLIBCXX_USE_C99_STDLIB
189
190#undef _Exit
191#undef llabs
192#undef lldiv
193#undef atoll
194#undef strtoll
195#undef strtoull
196#undef strtof
197#undef strtold
198
199namespace __gnu_cxx _GLIBCXX_VISIBILITY(default)
200{
201_GLIBCXX_BEGIN_NAMESPACE_VERSION
202
203#if !_GLIBCXX_USE_C99_LONG_LONG_DYNAMIC
204 using ::lldiv_t;
205#endif
206#if _GLIBCXX_USE_C99_CHECK || _GLIBCXX_USE_C99_DYNAMIC
207 extern "C" void (_Exit)(int) _GLIBCXX_NOTHROW _GLIBCXX_NORETURN;
208#endif
209#if !_GLIBCXX_USE_C99_DYNAMIC
210 using ::_Exit;
211#endif
212
213#if !_GLIBCXX_USE_C99_LONG_LONG_DYNAMIC
214 using ::llabs;
215
216 inline lldiv_t
217 div(long long __n, long long __d)
218 { lldiv_t __q; __q.quot = __n / __d; __q.rem = __n % __d; return __q; }
219
220 using ::lldiv;
221#endif
222
223#if _GLIBCXX_USE_C99_LONG_LONG_CHECK || _GLIBCXX_USE_C99_LONG_LONG_DYNAMIC
224 extern "C" long long int (atoll)(const char *) _GLIBCXX_NOTHROW;
225 extern "C" long long int
226 (strtoll)(const char * __restrict, char ** __restrict, int) _GLIBCXX_NOTHROW;
227 extern "C" unsigned long long int
228 (strtoull)(const char * __restrict, char ** __restrict, int) _GLIBCXX_NOTHROW;
229#endif
230#if !_GLIBCXX_USE_C99_LONG_LONG_DYNAMIC
231 using ::atoll;
232 using ::strtoll;
233 using ::strtoull;
234#endif
235 using ::strtof;
236 using ::strtold;
237
238_GLIBCXX_END_NAMESPACE_VERSION
239} // namespace __gnu_cxx
240
241namespace std
242{
243#if !_GLIBCXX_USE_C99_LONG_LONG_DYNAMIC
244 using ::__gnu_cxx::lldiv_t;
245#endif
246 using ::__gnu_cxx::_Exit;
247#if !_GLIBCXX_USE_C99_LONG_LONG_DYNAMIC
248 using ::__gnu_cxx::llabs;
249 using ::__gnu_cxx::div;
250 using ::__gnu_cxx::lldiv;
251#endif
252 using ::__gnu_cxx::atoll;
253 using ::__gnu_cxx::strtof;
254 using ::__gnu_cxx::strtoll;
255 using ::__gnu_cxx::strtoull;
256 using ::__gnu_cxx::strtold;
257} // namespace std
258
259#else // ! _GLIBCXX_USE_C99_STDLIB
260
261// We also check for strtof and strtold separately from _GLIBCXX_USE_C99_STDLIB
262
263#if _GLIBCXX_HAVE_STRTOF
264#undef strtof
265namespace std { using ::strtof; }
266#endif
267
268#if _GLIBCXX_HAVE_STRTOLD
269#undef strtold
270namespace std { using ::strtold; }
271#endif
272
273#endif // _GLIBCXX_USE_C99_STDLIB
274
275} // extern "C++"
276
277#endif // !_GLIBCXX_HOSTED
278
279#endif
280