lib/stdlib.in.h

   1 /* A GNU-like <stdlib.h>.
   2
   3    Copyright (C) 1995, 2001-2004, 2006-2009 Free Software Foundation, Inc.
   4
   5    This program is free software: you can redistribute it and/or modify
   6    it under the terms of the GNU General Public License as published by
   7    the Free Software Foundation; either version 3 of the License, or
   8    (at your option) any later version.
   9
  10    This program is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13    GNU General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  17
  18 #if __GNUC__ >= 3
  19 @PRAGMA_SYSTEM_HEADER@
  20 #endif
  21
  22 #if defined __need_malloc_and_calloc
  23 /* Special invocation convention inside glibc header files.  */
  24
  25 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
  26
  27 #else
  28 /* Normal invocation convention.  */
  29
  30 #ifndef _GL_STDLIB_H
  31
  32 /* The include_next requires a split double-inclusion guard.  */
  33 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
  34
  35 #ifndef _GL_STDLIB_H
  36 #define _GL_STDLIB_H
  37
  38 /* NetBSD 5.0 mis-defines NULL.  */
  39 #include <stddef.h>
  40
  41 /* Solaris declares getloadavg() in <sys/loadavg.h>.  */
  42 #if @GNULIB_GETLOADAVG@ && @HAVE_SYS_LOADAVG_H@
  43 # include <sys/loadavg.h>
  44 #endif
  45
  46 /* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
  47    from <stdlib.h> if _REENTRANT is defined.  Include it always.  */
  48 #if @HAVE_RANDOM_H@
  49 # include <random.h>
  50 #endif
  51
  52 #if @GNULIB_RANDOM_R@ || !@HAVE_STRUCT_RANDOM_DATA@
  53 # include <stdint.h>
  54 #endif
  55
  56 #if !@HAVE_STRUCT_RANDOM_DATA@
  57 struct random_data
  58 {
  59   int32_t *fptr;                /* Front pointer.  */
  60   int32_t *rptr;                /* Rear pointer.  */
  61   int32_t *state;               /* Array of state values.  */
  62   int rand_type;                /* Type of random number generator.  */
  63   int rand_deg;                 /* Degree of random number generator.  */
  64   int rand_sep;                 /* Distance between front and rear.  */
  65   int32_t *end_ptr;             /* Pointer behind state table.  */
  66 };
  67 #endif
  68
  69 /* The definition of GL_LINK_WARNING is copied here.  */
  70
  71
  72 /* Some systems do not define EXIT_*, despite otherwise supporting C89.  */
  73 #ifndef EXIT_SUCCESS
  74 # define EXIT_SUCCESS 0
  75 #endif
  76 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
  77    with proper operation of xargs.  */
  78 #ifndef EXIT_FAILURE
  79 # define EXIT_FAILURE 1
  80 #elif EXIT_FAILURE != 1
  81 # undef EXIT_FAILURE
  82 # define EXIT_FAILURE 1
  83 #endif
  84
  85
  86 #ifdef __cplusplus
  87 extern "C" {
  88 #endif
  89
  90
  91 #if @GNULIB_MALLOC_POSIX@
  92 # if !@HAVE_MALLOC_POSIX@
  93 #  undef malloc
  94 #  define malloc rpl_malloc
  95 extern void * malloc (size_t size);
  96 # endif
  97 #elif defined GNULIB_POSIXCHECK
  98 # undef malloc
  99 # define malloc(s) \
 100     (GL_LINK_WARNING ("malloc is not POSIX compliant everywhere - " \
 101                       "use gnulib module malloc-posix for portability"), \
 102      malloc (s))
 103 #endif
 104
 105
 106 #if @GNULIB_REALLOC_POSIX@
 107 # if !@HAVE_REALLOC_POSIX@
 108 #  undef realloc
 109 #  define realloc rpl_realloc
 110 extern void * realloc (void *ptr, size_t size);
 111 # endif
 112 #elif defined GNULIB_POSIXCHECK
 113 # undef realloc
 114 # define realloc(p,s) \
 115     (GL_LINK_WARNING ("realloc is not POSIX compliant everywhere - " \
 116                       "use gnulib module realloc-posix for portability"), \
 117      realloc (p, s))
 118 #endif
 119
 120
 121 #if @GNULIB_CALLOC_POSIX@
 122 # if !@HAVE_CALLOC_POSIX@
 123 #  undef calloc
 124 #  define calloc rpl_calloc
 125 extern void * calloc (size_t nmemb, size_t size);
 126 # endif
 127 #elif defined GNULIB_POSIXCHECK
 128 # undef calloc
 129 # define calloc(n,s) \
 130     (GL_LINK_WARNING ("calloc is not POSIX compliant everywhere - " \
 131                       "use gnulib module calloc-posix for portability"), \
 132      calloc (n, s))
 133 #endif
 134
 135
 136 #if @GNULIB_ATOLL@
 137 # if !@HAVE_ATOLL@
 138 /* Parse a signed decimal integer.
 139    Returns the value of the integer.  Errors are not detected.  */
 140 extern long long atoll (const char *string);
 141 # endif
 142 #elif defined GNULIB_POSIXCHECK
 143 # undef atoll
 144 # define atoll(s) \
 145     (GL_LINK_WARNING ("atoll is unportable - " \
 146                       "use gnulib module atoll for portability"), \
 147      atoll (s))
 148 #endif
 149
 150
 151 #if @GNULIB_GETLOADAVG@
 152 # if !@HAVE_DECL_GETLOADAVG@
 153 /* Store max(NELEM,3) load average numbers in LOADAVG[].
 154    The three numbers are the load average of the last 1 minute, the last 5
 155    minutes, and the last 15 minutes, respectively.
 156    LOADAVG is an array of NELEM numbers.  */
 157 extern int getloadavg (double loadavg[], int nelem);
 158 # endif
 159 #elif defined GNULIB_POSIXCHECK
 160 # undef getloadavg
 161 # define getloadavg(l,n) \
 162     (GL_LINK_WARNING ("getloadavg is not portable - " \
 163                       "use gnulib module getloadavg for portability"), \
 164      getloadavg (l, n))
 165 #endif
 166
 167
 168 #if @GNULIB_GETSUBOPT@
 169 /* Assuming *OPTIONP is a comma separated list of elements of the form
 170    "token" or "token=value", getsubopt parses the first of these elements.
 171    If the first element refers to a "token" that is member of the given
 172    NULL-terminated array of tokens:
 173      - It replaces the comma with a NUL byte, updates *OPTIONP to point past
 174        the first option and the comma, sets *VALUEP to the value of the
 175        element (or NULL if it doesn't contain an "=" sign),
 176      - It returns the index of the "token" in the given array of tokens.
 177    Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
 178    For more details see the POSIX:2001 specification.
 179    http://www.opengroup.org/susv3xsh/getsubopt.html */
 180 # if !@HAVE_GETSUBOPT@
 181 extern int getsubopt (char **optionp, char *const *tokens, char **valuep);
 182 # endif
 183 #elif defined GNULIB_POSIXCHECK
 184 # undef getsubopt
 185 # define getsubopt(o,t,v) \
 186     (GL_LINK_WARNING ("getsubopt is unportable - " \
 187                       "use gnulib module getsubopt for portability"), \
 188      getsubopt (o, t, v))
 189 #endif
 190
 191
 192 #if @GNULIB_MKDTEMP@
 193 # if !@HAVE_MKDTEMP@
 194 /* Create a unique temporary directory from TEMPLATE.
 195    The last six characters of TEMPLATE must be "XXXXXX";
 196    they are replaced with a string that makes the directory name unique.
 197    Returns TEMPLATE, or a null pointer if it cannot get a unique name.
 198    The directory is created mode 700.  */
 199 extern char * mkdtemp (char * /*template*/);
 200 # endif
 201 #elif defined GNULIB_POSIXCHECK
 202 # undef mkdtemp
 203 # define mkdtemp(t) \
 204     (GL_LINK_WARNING ("mkdtemp is unportable - " \
 205                       "use gnulib module mkdtemp for portability"), \
 206      mkdtemp (t))
 207 #endif
 208
 209
 210 #if @GNULIB_MKSTEMP@
 211 # if @REPLACE_MKSTEMP@
 212 /* Create a unique temporary file from TEMPLATE.
 213    The last six characters of TEMPLATE must be "XXXXXX";
 214    they are replaced with a string that makes the file name unique.
 215    The file is then created, ensuring it didn't exist before.
 216    The file is created read-write (mask at least 0600 & ~umask), but it may be
 217    world-readable and world-writable (mask 0666 & ~umask), depending on the
 218    implementation.
 219    Returns the open file descriptor if successful, otherwise -1 and errno
 220    set.  */
 221 #  define mkstemp rpl_mkstemp
 222 extern int mkstemp (char * /*template*/);
 223 # else
 224 /* On MacOS X 10.3, only <unistd.h> declares mkstemp.  */
 225 #  include <unistd.h>
 226 # endif
 227 #elif defined GNULIB_POSIXCHECK
 228 # undef mkstemp
 229 # define mkstemp(t) \
 230     (GL_LINK_WARNING ("mkstemp is unportable - " \
 231                       "use gnulib module mkstemp for portability"), \
 232      mkstemp (t))
 233 #endif
 234
 235
 236 #if @GNULIB_PUTENV@
 237 # if @REPLACE_PUTENV@
 238 #  undef putenv
 239 #  define putenv rpl_putenv
 240 extern int putenv (char *string);
 241 # endif
 242 #endif
 243
 244
 245 #if @GNULIB_RANDOM_R@
 246 # if !@HAVE_RANDOM_R@
 247
 248 #  ifndef RAND_MAX
 249 #   define RAND_MAX 2147483647
 250 #  endif
 251
 252 int srandom_r (unsigned int seed, struct random_data *rand_state);
 253 int initstate_r (unsigned int seed, char *buf, size_t buf_size,
 254                  struct random_data *rand_state);
 255 int setstate_r (char *arg_state, struct random_data *rand_state);
 256 int random_r (struct random_data *buf, int32_t *result);
 257 # endif
 258 #elif defined GNULIB_POSIXCHECK
 259 # undef random_r
 260 # define random_r(b,r)                            \
 261     (GL_LINK_WARNING ("random_r is unportable - " \
 262                       "use gnulib module random_r for portability"), \
 263      random_r (b,r))
 264 # undef initstate_r
 265 # define initstate_r(s,b,sz,r)                       \
 266     (GL_LINK_WARNING ("initstate_r is unportable - " \
 267                       "use gnulib module random_r for portability"), \
 268      initstate_r (s,b,sz,r))
 269 # undef srandom_r
 270 # define srandom_r(s,r)                            \
 271     (GL_LINK_WARNING ("srandom_r is unportable - " \
 272                       "use gnulib module random_r for portability"), \
 273      srandom_r (s,r))
 274 # undef setstate_r
 275 # define setstate_r(a,r)                                    \
 276     (GL_LINK_WARNING ("setstate_r is unportable - " \
 277                       "use gnulib module random_r for portability"), \
 278      setstate_r (a,r))
 279 #endif
 280
 281
 282 #if @GNULIB_RPMATCH@
 283 # if !@HAVE_RPMATCH@
 284 /* Test a user response to a question.
 285    Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear.  */
 286 extern int rpmatch (const char *response);
 287 # endif
 288 #elif defined GNULIB_POSIXCHECK
 289 # undef rpmatch
 290 # define rpmatch(r) \
 291     (GL_LINK_WARNING ("rpmatch is unportable - " \
 292                       "use gnulib module rpmatch for portability"), \
 293      rpmatch (r))
 294 #endif
 295
 296
 297 #if @GNULIB_SETENV@
 298 # if !@HAVE_SETENV@
 299 /* Set NAME to VALUE in the environment.
 300    If REPLACE is nonzero, overwrite an existing value.  */
 301 extern int setenv (const char *name, const char *value, int replace);
 302 # endif
 303 #endif
 304
 305
 306 #if @GNULIB_UNSETENV@
 307 # if @HAVE_UNSETENV@
 308 #  if @VOID_UNSETENV@
 309 /* On some systems, unsetenv() returns void.
 310    This is the case for MacOS X 10.3, FreeBSD 4.8, NetBSD 1.6, OpenBSD 3.4.  */
 311 #   define unsetenv(name) ((unsetenv)(name), 0)
 312 #  endif
 313 # else
 314 /* Remove the variable NAME from the environment.  */
 315 extern int unsetenv (const char *name);
 316 # endif
 317 #endif
 318
 319
 320 #if @GNULIB_STRTOD@
 321 # if @REPLACE_STRTOD@
 322 #  define strtod rpl_strtod
 323 # endif
 324 # if !@HAVE_STRTOD@ || @REPLACE_STRTOD@
 325  /* Parse a double from STRING, updating ENDP if appropriate.  */
 326 extern double strtod (const char *str, char **endp);
 327 # endif
 328 #elif defined GNULIB_POSIXCHECK
 329 # undef strtod
 330 # define strtod(s, e)                           \
 331     (GL_LINK_WARNING ("strtod is unportable - " \
 332                       "use gnulib module strtod for portability"), \
 333      strtod (s, e))
 334 #endif
 335
 336
 337 #if @GNULIB_STRTOLL@
 338 # if !@HAVE_STRTOLL@
 339 /* Parse a signed integer whose textual representation starts at STRING.
 340    The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
 341    it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
 342    "0x").
 343    If ENDPTR is not NULL, the address of the first byte after the integer is
 344    stored in *ENDPTR.
 345    Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
 346    to ERANGE.  */
 347 extern long long strtoll (const char *string, char **endptr, int base);
 348 # endif
 349 #elif defined GNULIB_POSIXCHECK
 350 # undef strtoll
 351 # define strtoll(s,e,b) \
 352     (GL_LINK_WARNING ("strtoll is unportable - " \
 353                       "use gnulib module strtoll for portability"), \
 354      strtoll (s, e, b))
 355 #endif
 356
 357
 358 #if @GNULIB_STRTOULL@
 359 # if !@HAVE_STRTOULL@
 360 /* Parse an unsigned integer whose textual representation starts at STRING.
 361    The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
 362    it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
 363    "0x").
 364    If ENDPTR is not NULL, the address of the first byte after the integer is
 365    stored in *ENDPTR.
 366    Upon overflow, the return value is ULLONG_MAX, and errno is set to
 367    ERANGE.  */
 368 extern unsigned long long strtoull (const char *string, char **endptr, int base);
 369 # endif
 370 #elif defined GNULIB_POSIXCHECK
 371 # undef strtoull
 372 # define strtoull(s,e,b) \
 373     (GL_LINK_WARNING ("strtoull is unportable - " \
 374                       "use gnulib module strtoull for portability"), \
 375      strtoull (s, e, b))
 376 #endif
 377
 378
 379 #ifdef __cplusplus
 380 }
 381 #endif
 382
 383 #endif /* _GL_STDLIB_H */
 384 #endif /* _GL_STDLIB_H */
 385 #endif