libstdc++-v3/include/c_global/cstdlib

   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
  56 namespace 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
 125 extern "C++"
 126 {
 127 namespace 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(__i, __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
 199 namespace __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
 241 namespace 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
 265 namespace std { using ::strtof; }
 266 #endif
 267
 268 #if _GLIBCXX_HAVE_STRTOLD
 269 #undef strtold
 270 namespace std { using ::strtold; }
 271 #endif
 272
 273 #endif // _GLIBCXX_USE_C99_STDLIB
 274
 275 } // extern "C++"
 276
 277 #endif // !_GLIBCXX_HOSTED
 278
 279 #endif