lib/stdlib.in.h

   1 /* A GNU-like <stdlib.h>.
   2
   3    Copyright (C) 1995, 2001-2004, 2006-2010 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@ || defined GNULIB_POSIXCHECK) && @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 !@HAVE_STRUCT_RANDOM_DATA@ || (@GNULIB_RANDOM_R@ && !@HAVE_RANDOM_R@) \
  53     || defined GNULIB_POSIXCHECK
  54 # include <stdint.h>
  55 #endif
  56
  57 #if !@HAVE_STRUCT_RANDOM_DATA@
  58 struct random_data
  59 {
  60   int32_t *fptr;                /* Front pointer.  */
  61   int32_t *rptr;                /* Rear pointer.  */
  62   int32_t *state;               /* Array of state values.  */
  63   int rand_type;                /* Type of random number generator.  */
  64   int rand_deg;                 /* Degree of random number generator.  */
  65   int rand_sep;                 /* Distance between front and rear.  */
  66   int32_t *end_ptr;             /* Pointer behind state table.  */
  67 };
  68 #endif
  69
  70 #if (@GNULIB_MKSTEMP@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__
  71 /* On MacOS X 10.3, only <unistd.h> declares mkstemp.  */
  72 /* On Cygwin 1.7.1, only <unistd.h> declares getsubopt.  */
  73 /* But avoid namespace pollution on glibc systems.  */
  74 # include <unistd.h>
  75 #endif
  76
  77 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
  78
  79 /* The definition of _GL_ARG_NONNULL is copied here.  */
  80
  81 /* The definition of _GL_WARN_ON_USE is copied here.  */
  82
  83
  84 /* Some systems do not define EXIT_*, despite otherwise supporting C89.  */
  85 #ifndef EXIT_SUCCESS
  86 # define EXIT_SUCCESS 0
  87 #endif
  88 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
  89    with proper operation of xargs.  */
  90 #ifndef EXIT_FAILURE
  91 # define EXIT_FAILURE 1
  92 #elif EXIT_FAILURE != 1
  93 # undef EXIT_FAILURE
  94 # define EXIT_FAILURE 1
  95 #endif
  96
  97
  98 #if @GNULIB_ATOLL@
  99 /* Parse a signed decimal integer.
 100    Returns the value of the integer.  Errors are not detected.  */
 101 # if !@HAVE_ATOLL@
 102 _GL_FUNCDECL_SYS (atoll, long long, (const char *string) _GL_ARG_NONNULL ((1)));
 103 # endif
 104 _GL_CXXALIAS_SYS (atoll, long long, (const char *string));
 105 _GL_CXXALIASWARN (atoll);
 106 #elif defined GNULIB_POSIXCHECK
 107 # undef atoll
 108 # if HAVE_RAW_DECL_ATOLL
 109 _GL_WARN_ON_USE (atoll, "atoll is unportable - "
 110                  "use gnulib module atoll for portability");
 111 # endif
 112 #endif
 113
 114 #if @GNULIB_CALLOC_POSIX@
 115 # if !@HAVE_CALLOC_POSIX@
 116 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 117 #   undef calloc
 118 #   define calloc rpl_calloc
 119 #  endif
 120 _GL_FUNCDECL_RPL (calloc, void *, (size_t nmemb, size_t size));
 121 _GL_CXXALIAS_RPL (calloc, void *, (size_t nmemb, size_t size));
 122 # else
 123 _GL_CXXALIAS_SYS (calloc, void *, (size_t nmemb, size_t size));
 124 # endif
 125 _GL_CXXALIASWARN (calloc);
 126 #elif defined GNULIB_POSIXCHECK
 127 # undef calloc
 128 /* Assume calloc is always declared.  */
 129 _GL_WARN_ON_USE (calloc, "calloc is not POSIX compliant everywhere - "
 130                  "use gnulib module calloc-posix for portability");
 131 #endif
 132
 133 #if @GNULIB_CANONICALIZE_FILE_NAME@
 134 # if @REPLACE_CANONICALIZE_FILE_NAME@
 135 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 136 #   define canonicalize_file_name rpl_canonicalize_file_name
 137 #  endif
 138 _GL_FUNCDECL_RPL (canonicalize_file_name, char *, (const char *name)
 139                                                   _GL_ARG_NONNULL ((1)));
 140 _GL_CXXALIAS_RPL (canonicalize_file_name, char *, (const char *name));
 141 # else
 142 #  if !@HAVE_CANONICALIZE_FILE_NAME@
 143 _GL_FUNCDECL_SYS (canonicalize_file_name, char *, (const char *name)
 144                                                   _GL_ARG_NONNULL ((1)));
 145 #  endif
 146 _GL_CXXALIAS_SYS (canonicalize_file_name, char *, (const char *name));
 147 # endif
 148 _GL_CXXALIASWARN (canonicalize_file_name);
 149 #elif defined GNULIB_POSIXCHECK
 150 # undef canonicalize_file_name
 151 # if HAVE_RAW_DECL_CANONICALIZE_FILE_NAME
 152 _GL_WARN_ON_USE (canonicalize_file_name, "canonicalize_file_name is unportable - "
 153                  "use gnulib module canonicalize-lgpl for portability");
 154 # endif
 155 #endif
 156
 157 #if @GNULIB_GETLOADAVG@
 158 /* Store max(NELEM,3) load average numbers in LOADAVG[].
 159    The three numbers are the load average of the last 1 minute, the last 5
 160    minutes, and the last 15 minutes, respectively.
 161    LOADAVG is an array of NELEM numbers.  */
 162 # if !@HAVE_DECL_GETLOADAVG@
 163 _GL_FUNCDECL_SYS (getloadavg, int, (double loadavg[], int nelem)
 164                                    _GL_ARG_NONNULL ((1)));
 165 # endif
 166 _GL_CXXALIAS_SYS (getloadavg, int, (double loadavg[], int nelem));
 167 _GL_CXXALIASWARN (getloadavg);
 168 #elif defined GNULIB_POSIXCHECK
 169 # undef getloadavg
 170 # if HAVE_RAW_DECL_GETLOADAVG
 171 _GL_WARN_ON_USE (getloadavg, "getloadavg is not portable - "
 172                  "use gnulib module getloadavg for portability");
 173 # endif
 174 #endif
 175
 176 #if @GNULIB_GETSUBOPT@
 177 /* Assuming *OPTIONP is a comma separated list of elements of the form
 178    "token" or "token=value", getsubopt parses the first of these elements.
 179    If the first element refers to a "token" that is member of the given
 180    NULL-terminated array of tokens:
 181      - It replaces the comma with a NUL byte, updates *OPTIONP to point past
 182        the first option and the comma, sets *VALUEP to the value of the
 183        element (or NULL if it doesn't contain an "=" sign),
 184      - It returns the index of the "token" in the given array of tokens.
 185    Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
 186    For more details see the POSIX:2001 specification.
 187    http://www.opengroup.org/susv3xsh/getsubopt.html */
 188 # if !@HAVE_GETSUBOPT@
 189 _GL_FUNCDECL_SYS (getsubopt, int,
 190                   (char **optionp, char *const *tokens, char **valuep)
 191                   _GL_ARG_NONNULL ((1, 2, 3)));
 192 # endif
 193 _GL_CXXALIAS_SYS (getsubopt, int,
 194                   (char **optionp, char *const *tokens, char **valuep));
 195 _GL_CXXALIASWARN (getsubopt);
 196 #elif defined GNULIB_POSIXCHECK
 197 # undef getsubopt
 198 # if HAVE_RAW_DECL_GETSUBOPT
 199 _GL_WARN_ON_USE (getsubopt, "getsubopt is unportable - "
 200                  "use gnulib module getsubopt for portability");
 201 # endif
 202 #endif
 203
 204 #if @GNULIB_MALLOC_POSIX@
 205 # if !@HAVE_MALLOC_POSIX@
 206 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 207 #   undef malloc
 208 #   define malloc rpl_malloc
 209 #  endif
 210 _GL_FUNCDECL_RPL (malloc, void *, (size_t size));
 211 _GL_CXXALIAS_RPL (malloc, void *, (size_t size));
 212 # else
 213 _GL_CXXALIAS_SYS (malloc, void *, (size_t size));
 214 # endif
 215 _GL_CXXALIASWARN (malloc);
 216 #elif defined GNULIB_POSIXCHECK
 217 # undef malloc
 218 /* Assume malloc is always declared.  */
 219 _GL_WARN_ON_USE (malloc, "malloc is not POSIX compliant everywhere - "
 220                  "use gnulib module malloc-posix for portability");
 221 #endif
 222
 223 #if @GNULIB_MKDTEMP@
 224 /* Create a unique temporary directory from TEMPLATE.
 225    The last six characters of TEMPLATE must be "XXXXXX";
 226    they are replaced with a string that makes the directory name unique.
 227    Returns TEMPLATE, or a null pointer if it cannot get a unique name.
 228    The directory is created mode 700.  */
 229 # if !@HAVE_MKDTEMP@
 230 _GL_FUNCDECL_SYS (mkdtemp, char *, (char * /*template*/) _GL_ARG_NONNULL ((1)));
 231 # endif
 232 _GL_CXXALIAS_SYS (mkdtemp, char *, (char * /*template*/));
 233 _GL_CXXALIASWARN (mkdtemp);
 234 #elif defined GNULIB_POSIXCHECK
 235 # undef mkdtemp
 236 # if HAVE_RAW_DECL_MKDTEMP
 237 _GL_WARN_ON_USE (mkdtemp, "mkdtemp is unportable - "
 238                  "use gnulib module mkdtemp for portability");
 239 # endif
 240 #endif
 241
 242 #if @GNULIB_MKOSTEMP@
 243 /* Create a unique temporary file from TEMPLATE.
 244    The last six characters of TEMPLATE must be "XXXXXX";
 245    they are replaced with a string that makes the file name unique.
 246    The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
 247    and O_TEXT, O_BINARY (defined in "binary-io.h").
 248    The file is then created, with the specified flags, ensuring it didn't exist
 249    before.
 250    The file is created read-write (mask at least 0600 & ~umask), but it may be
 251    world-readable and world-writable (mask 0666 & ~umask), depending on the
 252    implementation.
 253    Returns the open file descriptor if successful, otherwise -1 and errno
 254    set.  */
 255 # if !@HAVE_MKOSTEMP@
 256 _GL_FUNCDECL_SYS (mkostemp, int, (char * /*template*/, int /*flags*/)
 257                                  _GL_ARG_NONNULL ((1)));
 258 # endif
 259 _GL_CXXALIAS_SYS (mkostemp, int, (char * /*template*/, int /*flags*/));
 260 _GL_CXXALIASWARN (mkostemp);
 261 #elif defined GNULIB_POSIXCHECK
 262 # undef mkostemp
 263 # if HAVE_RAW_DECL_MKOSTEMP
 264 _GL_WARN_ON_USE (mkostemp, "mkostemp is unportable - "
 265                  "use gnulib module mkostemp for portability");
 266 # endif
 267 #endif
 268
 269 #if @GNULIB_MKOSTEMPS@
 270 /* Create a unique temporary file from TEMPLATE.
 271    The last six characters of TEMPLATE before a suffix of length
 272    SUFFIXLEN must be "XXXXXX";
 273    they are replaced with a string that makes the file name unique.
 274    The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
 275    and O_TEXT, O_BINARY (defined in "binary-io.h").
 276    The file is then created, with the specified flags, ensuring it didn't exist
 277    before.
 278    The file is created read-write (mask at least 0600 & ~umask), but it may be
 279    world-readable and world-writable (mask 0666 & ~umask), depending on the
 280    implementation.
 281    Returns the open file descriptor if successful, otherwise -1 and errno
 282    set.  */
 283 # if !@HAVE_MKOSTEMPS@
 284 _GL_FUNCDECL_SYS (mkostemps, int,
 285                   (char * /*template*/, int /*suffixlen*/, int /*flags*/)
 286                   _GL_ARG_NONNULL ((1)));
 287 # endif
 288 _GL_CXXALIAS_SYS (mkostemps, int,
 289                   (char * /*template*/, int /*suffixlen*/, int /*flags*/));
 290 _GL_CXXALIASWARN (mkostemps);
 291 #elif defined GNULIB_POSIXCHECK
 292 # undef mkostemps
 293 # if HAVE_RAW_DECL_MKOSTEMPS
 294 _GL_WARN_ON_USE (mkostemps, "mkostemps is unportable - "
 295                  "use gnulib module mkostemps for portability");
 296 # endif
 297 #endif
 298
 299 #if @GNULIB_MKSTEMP@
 300 /* Create a unique temporary file from TEMPLATE.
 301    The last six characters of TEMPLATE must be "XXXXXX";
 302    they are replaced with a string that makes the file name unique.
 303    The file is then created, ensuring it didn't exist before.
 304    The file is created read-write (mask at least 0600 & ~umask), but it may be
 305    world-readable and world-writable (mask 0666 & ~umask), depending on the
 306    implementation.
 307    Returns the open file descriptor if successful, otherwise -1 and errno
 308    set.  */
 309 # if @REPLACE_MKSTEMP@
 310 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 311 #   define mkstemp rpl_mkstemp
 312 #  endif
 313 _GL_FUNCDECL_RPL (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
 314 _GL_CXXALIAS_RPL (mkstemp, int, (char * /*template*/));
 315 # else
 316 _GL_CXXALIAS_SYS (mkstemp, int, (char * /*template*/));
 317 # endif
 318 _GL_CXXALIASWARN (mkstemp);
 319 #elif defined GNULIB_POSIXCHECK
 320 # undef mkstemp
 321 # if HAVE_RAW_DECL_MKSTEMP
 322 _GL_WARN_ON_USE (mkstemp, "mkstemp is unportable - "
 323                  "use gnulib module mkstemp for portability");
 324 # endif
 325 #endif
 326
 327 #if @GNULIB_MKSTEMPS@
 328 /* Create a unique temporary file from TEMPLATE.
 329    The last six characters of TEMPLATE prior to a suffix of length
 330    SUFFIXLEN must be "XXXXXX";
 331    they are replaced with a string that makes the file name unique.
 332    The file is then created, ensuring it didn't exist before.
 333    The file is created read-write (mask at least 0600 & ~umask), but it may be
 334    world-readable and world-writable (mask 0666 & ~umask), depending on the
 335    implementation.
 336    Returns the open file descriptor if successful, otherwise -1 and errno
 337    set.  */
 338 # if !@HAVE_MKSTEMPS@
 339 _GL_FUNCDECL_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/)
 340                                  _GL_ARG_NONNULL ((1)));
 341 # endif
 342 _GL_CXXALIAS_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/));
 343 _GL_CXXALIASWARN (mkstemps);
 344 #elif defined GNULIB_POSIXCHECK
 345 # undef mkstemps
 346 # if HAVE_RAW_DECL_MKSTEMPS
 347 _GL_WARN_ON_USE (mkstemps, "mkstemps is unportable - "
 348                  "use gnulib module mkstemps for portability");
 349 # endif
 350 #endif
 351
 352 #if @GNULIB_PTSNAME@
 353 /* Return the pathname of the pseudo-terminal slave associated with
 354    the master FD is open on, or NULL on errors.  */
 355 # if !@HAVE_PTSNAME@
 356 _GL_FUNCDECL_SYS (ptsname, char *, (int fd));
 357 # endif
 358 _GL_CXXALIAS_SYS (ptsname, char *, (int fd));
 359 _GL_CXXALIASWARN (ptsname);
 360 #elif defined GNULIB_POSIXCHECK
 361 # undef ptsname
 362 # if HAVE_RAW_DECL_PTSNAME
 363 _GL_WARN_ON_USE (ptsname, "ptsname is not portable - "
 364                  "use gnulib module ptsname for portability");
 365 # endif
 366 #endif
 367
 368 #if @GNULIB_PUTENV@
 369 # if @REPLACE_PUTENV@
 370 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 371 #   undef putenv
 372 #   define putenv rpl_putenv
 373 #  endif
 374 _GL_FUNCDECL_RPL (putenv, int, (char *string) _GL_ARG_NONNULL ((1)));
 375 _GL_CXXALIAS_RPL (putenv, int, (char *string));
 376 # else
 377 _GL_CXXALIAS_SYS (putenv, int, (char *string));
 378 # endif
 379 _GL_CXXALIASWARN (putenv);
 380 #endif
 381
 382
 383 #if @GNULIB_RANDOM_R@
 384 # if !@HAVE_RANDOM_R@
 385 #  ifndef RAND_MAX
 386 #   define RAND_MAX 2147483647
 387 #  endif
 388 # endif
 389 #endif
 390
 391 #if @GNULIB_RANDOM_R@
 392 # if !@HAVE_RANDOM_R@
 393 _GL_FUNCDECL_SYS (random_r, int, (struct random_data *buf, int32_t *result)
 394                                  _GL_ARG_NONNULL ((1, 2)));
 395 # endif
 396 _GL_CXXALIAS_SYS (random_r, int, (struct random_data *buf, int32_t *result));
 397 _GL_CXXALIASWARN (random_r);
 398 #elif defined GNULIB_POSIXCHECK
 399 # undef random_r
 400 # if HAVE_RAW_DECL_RANDOM_R
 401 _GL_WARN_ON_USE (random_r, "random_r is unportable - "
 402                  "use gnulib module random_r for portability");
 403 # endif
 404 #endif
 405
 406 #if @GNULIB_RANDOM_R@
 407 # if !@HAVE_RANDOM_R@
 408 _GL_FUNCDECL_SYS (srandom_r, int,
 409                   (unsigned int seed, struct random_data *rand_state)
 410                   _GL_ARG_NONNULL ((2)));
 411 # endif
 412 _GL_CXXALIAS_SYS (srandom_r, int,
 413                   (unsigned int seed, struct random_data *rand_state));
 414 _GL_CXXALIASWARN (srandom_r);
 415 #elif defined GNULIB_POSIXCHECK
 416 # undef srandom_r
 417 # if HAVE_RAW_DECL_SRANDOM_R
 418 _GL_WARN_ON_USE (srandom_r, "srandom_r is unportable - "
 419                  "use gnulib module random_r for portability");
 420 # endif
 421 #endif
 422
 423 #if @GNULIB_RANDOM_R@
 424 # if !@HAVE_RANDOM_R@
 425 _GL_FUNCDECL_SYS (initstate_r, int,
 426                   (unsigned int seed, char *buf, size_t buf_size,
 427                    struct random_data *rand_state)
 428                   _GL_ARG_NONNULL ((2, 4)));
 429 # endif
 430 _GL_CXXALIAS_SYS (initstate_r, int,
 431                   (unsigned int seed, char *buf, size_t buf_size,
 432                    struct random_data *rand_state));
 433 _GL_CXXALIASWARN (initstate_r);
 434 #elif defined GNULIB_POSIXCHECK
 435 # undef initstate_r
 436 # if HAVE_RAW_DECL_INITSTATE_R
 437 _GL_WARN_ON_USE (initstate_r, "initstate_r is unportable - "
 438                  "use gnulib module random_r for portability");
 439 # endif
 440 #endif
 441
 442 #if @GNULIB_RANDOM_R@
 443 # if !@HAVE_RANDOM_R@
 444 _GL_FUNCDECL_SYS (setstate_r, int,
 445                   (char *arg_state, struct random_data *rand_state)
 446                   _GL_ARG_NONNULL ((1, 2)));
 447 # endif
 448 _GL_CXXALIAS_SYS (setstate_r, int,
 449                   (char *arg_state, struct random_data *rand_state));
 450 _GL_CXXALIASWARN (setstate_r);
 451 #elif defined GNULIB_POSIXCHECK
 452 # undef setstate_r
 453 # if HAVE_RAW_DECL_SETSTATE_R
 454 _GL_WARN_ON_USE (setstate_r, "setstate_r is unportable - "
 455                  "use gnulib module random_r for portability");
 456 # endif
 457 #endif
 458
 459
 460 #if @GNULIB_REALLOC_POSIX@
 461 # if !@HAVE_REALLOC_POSIX@
 462 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 463 #   undef realloc
 464 #   define realloc rpl_realloc
 465 #  endif
 466 _GL_FUNCDECL_RPL (realloc, void *, (void *ptr, size_t size));
 467 _GL_CXXALIAS_RPL (realloc, void *, (void *ptr, size_t size));
 468 # else
 469 _GL_CXXALIAS_SYS (realloc, void *, (void *ptr, size_t size));
 470 # endif
 471 _GL_CXXALIASWARN (realloc);
 472 #elif defined GNULIB_POSIXCHECK
 473 # undef realloc
 474 /* Assume realloc is always declared.  */
 475 _GL_WARN_ON_USE (realloc, "realloc is not POSIX compliant everywhere - "
 476                  "use gnulib module realloc-posix for portability");
 477 #endif
 478
 479 #if @GNULIB_REALPATH@
 480 # if @REPLACE_REALPATH@
 481 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 482 #   define realpath rpl_realpath
 483 #  endif
 484 _GL_FUNCDECL_RPL (realpath, char *, (const char *name, char *resolved)
 485                                     _GL_ARG_NONNULL ((1)));
 486 _GL_CXXALIAS_RPL (realpath, char *, (const char *name, char *resolved));
 487 # else
 488 #  if !@HAVE_REALPATH@
 489 _GL_FUNCDECL_SYS (realpath, char *, (const char *name, char *resolved)
 490                                     _GL_ARG_NONNULL ((1)));
 491 #  endif
 492 _GL_CXXALIAS_SYS (realpath, char *, (const char *name, char *resolved));
 493 # endif
 494 _GL_CXXALIASWARN (realpath);
 495 #elif defined GNULIB_POSIXCHECK
 496 # undef realpath
 497 # if HAVE_RAW_DECL_REALPATH
 498 _GL_WARN_ON_USE (realpath, "realpath is unportable - use gnulib module "
 499                  "canonicalize or canonicalize-lgpl for portability");
 500 # endif
 501 #endif
 502
 503 #if @GNULIB_RPMATCH@
 504 /* Test a user response to a question.
 505    Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear.  */
 506 # if !@HAVE_RPMATCH@
 507 _GL_FUNCDECL_SYS (rpmatch, int, (const char *response) _GL_ARG_NONNULL ((1)));
 508 # endif
 509 _GL_CXXALIAS_SYS (rpmatch, int, (const char *response));
 510 _GL_CXXALIASWARN (rpmatch);
 511 #elif defined GNULIB_POSIXCHECK
 512 # undef rpmatch
 513 # if HAVE_RAW_DECL_RPMATCH
 514 _GL_WARN_ON_USE (rpmatch, "rpmatch is unportable - "
 515                  "use gnulib module rpmatch for portability");
 516 # endif
 517 #endif
 518
 519 #if @GNULIB_SETENV@
 520 /* Set NAME to VALUE in the environment.
 521    If REPLACE is nonzero, overwrite an existing value.  */
 522 # if @REPLACE_SETENV@
 523 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 524 #   undef setenv
 525 #   define setenv rpl_setenv
 526 #  endif
 527 _GL_FUNCDECL_RPL (setenv, int,
 528                   (const char *name, const char *value, int replace)
 529                   _GL_ARG_NONNULL ((1)));
 530 _GL_CXXALIAS_RPL (setenv, int,
 531                   (const char *name, const char *value, int replace));
 532 # else
 533 #  if !@HAVE_SETENV@
 534 _GL_FUNCDECL_SYS (setenv, int,
 535                   (const char *name, const char *value, int replace)
 536                   _GL_ARG_NONNULL ((1)));
 537 #  endif
 538 _GL_CXXALIAS_SYS (setenv, int,
 539                   (const char *name, const char *value, int replace));
 540 # endif
 541 _GL_CXXALIASWARN (setenv);
 542 #elif defined GNULIB_POSIXCHECK
 543 # undef setenv
 544 # if HAVE_RAW_DECL_SETENV
 545 _GL_WARN_ON_USE (setenv, "setenv is unportable - "
 546                  "use gnulib module setenv for portability");
 547 # endif
 548 #endif
 549
 550 #if @GNULIB_STRTOD@
 551  /* Parse a double from STRING, updating ENDP if appropriate.  */
 552 # if @REPLACE_STRTOD@
 553 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 554 #   define strtod rpl_strtod
 555 #  endif
 556 _GL_FUNCDECL_RPL (strtod, double, (const char *str, char **endp)
 557                                   _GL_ARG_NONNULL ((1)));
 558 _GL_CXXALIAS_RPL (strtod, double, (const char *str, char **endp));
 559 # else
 560 #  if !@HAVE_STRTOD@
 561 _GL_FUNCDECL_SYS (strtod, double, (const char *str, char **endp)
 562                                   _GL_ARG_NONNULL ((1)));
 563 #  endif
 564 _GL_CXXALIAS_SYS (strtod, double, (const char *str, char **endp));
 565 # endif
 566 _GL_CXXALIASWARN (strtod);
 567 #elif defined GNULIB_POSIXCHECK
 568 # undef strtod
 569 # if HAVE_RAW_DECL_STRTOD
 570 _GL_WARN_ON_USE (strtod, "strtod is unportable - "
 571                  "use gnulib module strtod for portability");
 572 # endif
 573 #endif
 574
 575 #if @GNULIB_STRTOLL@
 576 /* Parse a signed integer whose textual representation starts at STRING.
 577    The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
 578    it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
 579    "0x").
 580    If ENDPTR is not NULL, the address of the first byte after the integer is
 581    stored in *ENDPTR.
 582    Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
 583    to ERANGE.  */
 584 # if !@HAVE_STRTOLL@
 585 _GL_FUNCDECL_SYS (strtoll, long long,
 586                   (const char *string, char **endptr, int base)
 587                   _GL_ARG_NONNULL ((1)));
 588 # endif
 589 _GL_CXXALIAS_SYS (strtoll, long long,
 590                   (const char *string, char **endptr, int base));
 591 _GL_CXXALIASWARN (strtoll);
 592 #elif defined GNULIB_POSIXCHECK
 593 # undef strtoll
 594 # if HAVE_RAW_DECL_STRTOLL
 595 _GL_WARN_ON_USE (strtoll, "strtoll is unportable - "
 596                  "use gnulib module strtoll for portability");
 597 # endif
 598 #endif
 599
 600 #if @GNULIB_STRTOULL@
 601 /* Parse an unsigned integer whose textual representation starts at STRING.
 602    The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
 603    it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
 604    "0x").
 605    If ENDPTR is not NULL, the address of the first byte after the integer is
 606    stored in *ENDPTR.
 607    Upon overflow, the return value is ULLONG_MAX, and errno is set to
 608    ERANGE.  */
 609 # if !@HAVE_STRTOULL@
 610 _GL_FUNCDECL_SYS (strtoull, unsigned long long,
 611                   (const char *string, char **endptr, int base)
 612                   _GL_ARG_NONNULL ((1)));
 613 # endif
 614 _GL_CXXALIAS_SYS (strtoull, unsigned long long,
 615                   (const char *string, char **endptr, int base));
 616 _GL_CXXALIASWARN (strtoull);
 617 #elif defined GNULIB_POSIXCHECK
 618 # undef strtoull
 619 # if HAVE_RAW_DECL_STRTOULL
 620 _GL_WARN_ON_USE (strtoull, "strtoull is unportable - "
 621                  "use gnulib module strtoull for portability");
 622 # endif
 623 #endif
 624
 625 #if @GNULIB_UNSETENV@
 626 /* Remove the variable NAME from the environment.  */
 627 # if @REPLACE_UNSETENV@
 628 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 629 #   undef unsetenv
 630 #   define unsetenv rpl_unsetenv
 631 #  endif
 632 _GL_FUNCDECL_RPL (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
 633 _GL_CXXALIAS_RPL (unsetenv, int, (const char *name));
 634 # else
 635 #  if !@HAVE_UNSETENV@
 636 _GL_FUNCDECL_SYS (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
 637 #  endif
 638 _GL_CXXALIAS_SYS (unsetenv, int, (const char *name));
 639 # endif
 640 _GL_CXXALIASWARN (unsetenv);
 641 #elif defined GNULIB_POSIXCHECK
 642 # undef unsetenv
 643 # if HAVE_RAW_DECL_UNSETENV
 644 _GL_WARN_ON_USE (unsetenv, "unsetenv is unportable - "
 645                  "use gnulib module unsetenv for portability");
 646 # endif
 647 #endif
 648
 649
 650 #endif /* _GL_STDLIB_H */
 651 #endif /* _GL_STDLIB_H */
 652 #endif