| /* Copyright (C) 1991-2003,2004,2005,2006,2007 Free Software Foundation, Inc. |
| This file is part of the GNU C Library. |
| |
| The GNU C Library is free software; you can redistribute it and/or |
| modify it under the terms of the GNU Lesser General Public |
| License as published by the Free Software Foundation; either |
| version 2.1 of the License, or (at your option) any later version. |
| |
| The GNU C Library is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| Lesser General Public License for more details. |
| |
| You should have received a copy of the GNU Lesser General Public |
| License along with the GNU C Library; if not, write to the Free |
| Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA |
| 02111-1307 USA. */ |
| |
| /* |
| * ISO C99 Standard: 7.20 General utilities <stdlib.h> |
| */ |
| |
| #ifndef _STDLIB_H |
| |
| #include <features.h> |
| |
| /* Get size_t, wchar_t and NULL from <stddef.h>. */ |
| #define __need_size_t |
| #ifndef __need_malloc_and_calloc |
| # define __need_wchar_t |
| # define __need_NULL |
| #endif |
| #include <stddef.h> |
| |
| __BEGIN_DECLS |
| |
| #ifndef __need_malloc_and_calloc |
| #define _STDLIB_H 1 |
| |
| #if defined __USE_XOPEN && !defined _SYS_WAIT_H |
| /* XPG requires a few symbols from <sys/wait.h> being defined. */ |
| # include <bits/waitflags.h> |
| # include <bits/waitstatus.h> |
| |
| # ifdef __USE_BSD |
| |
| /* Lots of hair to allow traditional BSD use of `union wait' |
| as well as POSIX.1 use of `int' for the status word. */ |
| |
| # if defined __GNUC__ && !defined __cplusplus |
| # define __WAIT_INT(status) \ |
| (__extension__ ({ union { __typeof(status) __in; int __i; } __u; \ |
| __u.__in = (status); __u.__i; })) |
| # else |
| # define __WAIT_INT(status) (*(int *) &(status)) |
| # endif |
| |
| /* This is the type of the argument to `wait'. The funky union |
| causes redeclarations with ether `int *' or `union wait *' to be |
| allowed without complaint. __WAIT_STATUS_DEFN is the type used in |
| the actual function definitions. */ |
| |
| # if !defined __GNUC__ || __GNUC__ < 2 || defined __cplusplus |
| # define __WAIT_STATUS void * |
| # define __WAIT_STATUS_DEFN void * |
| # else |
| /* This works in GCC 2.6.1 and later. */ |
| typedef union |
| { |
| union wait *__uptr; |
| int *__iptr; |
| } __WAIT_STATUS __attribute__ ((__transparent_union__)); |
| # define __WAIT_STATUS_DEFN int * |
| # endif |
| |
| # else /* Don't use BSD. */ |
| |
| # define __WAIT_INT(status) (status) |
| # define __WAIT_STATUS int * |
| # define __WAIT_STATUS_DEFN int * |
| |
| # endif /* Use BSD. */ |
| |
| /* Define the macros <sys/wait.h> also would define this way. */ |
| # define WEXITSTATUS(status) __WEXITSTATUS(__WAIT_INT(status)) |
| # define WTERMSIG(status) __WTERMSIG(__WAIT_INT(status)) |
| # define WSTOPSIG(status) __WSTOPSIG(__WAIT_INT(status)) |
| # define WIFEXITED(status) __WIFEXITED(__WAIT_INT(status)) |
| # define WIFSIGNALED(status) __WIFSIGNALED(__WAIT_INT(status)) |
| # define WIFSTOPPED(status) __WIFSTOPPED(__WAIT_INT(status)) |
| # ifdef __WIFCONTINUED |
| # define WIFCONTINUED(status) __WIFCONTINUED(__WAIT_INT(status)) |
| # endif |
| #endif /* X/Open and <sys/wait.h> not included. */ |
| |
| __BEGIN_NAMESPACE_STD |
| /* Returned by `div'. */ |
| typedef struct |
| { |
| int quot; /* Quotient. */ |
| int rem; /* Remainder. */ |
| } div_t; |
| |
| /* Returned by `ldiv'. */ |
| #ifndef __ldiv_t_defined |
| typedef struct |
| { |
| long int quot; /* Quotient. */ |
| long int rem; /* Remainder. */ |
| } ldiv_t; |
| # define __ldiv_t_defined 1 |
| #endif |
| __END_NAMESPACE_STD |
| |
| #if defined __USE_ISOC99 && !defined __lldiv_t_defined |
| __BEGIN_NAMESPACE_C99 |
| /* Returned by `lldiv'. */ |
| __extension__ typedef struct |
| { |
| long long int quot; /* Quotient. */ |
| long long int rem; /* Remainder. */ |
| } lldiv_t; |
| # define __lldiv_t_defined 1 |
| __END_NAMESPACE_C99 |
| #endif |
| |
| |
| /* The largest number rand will return (same as INT_MAX). */ |
| #define RAND_MAX 2147483647 |
| |
| |
| /* We define these the same for all machines. |
| Changes from this to the outside world should be done in `_exit'. */ |
| #define EXIT_FAILURE 1 /* Failing exit status. */ |
| #define EXIT_SUCCESS 0 /* Successful exit status. */ |
| |
| |
| /* Maximum length of a multibyte character in the current locale. */ |
| #define MB_CUR_MAX (__ctype_get_mb_cur_max ()) |
| extern size_t __ctype_get_mb_cur_max (void) __THROW __wur; |
| |
| |
| __BEGIN_NAMESPACE_STD |
| /* Convert a string to a floating-point number. */ |
| extern double atof (__const char *__nptr) |
| __THROW __attribute_pure__ __nonnull ((1)) __wur; |
| /* Convert a string to an integer. */ |
| extern int atoi (__const char *__nptr) |
| __THROW __attribute_pure__ __nonnull ((1)) __wur; |
| /* Convert a string to a long integer. */ |
| extern long int atol (__const char *__nptr) |
| __THROW __attribute_pure__ __nonnull ((1)) __wur; |
| __END_NAMESPACE_STD |
| |
| #if defined __USE_ISOC99 || (defined __GLIBC_HAVE_LONG_LONG && defined __USE_MISC) |
| __BEGIN_NAMESPACE_C99 |
| /* Convert a string to a long long integer. */ |
| __extension__ extern long long int atoll (__const char *__nptr) |
| __THROW __attribute_pure__ __nonnull ((1)) __wur; |
| __END_NAMESPACE_C99 |
| #endif |
| |
| __BEGIN_NAMESPACE_STD |
| /* Convert a string to a floating-point number. */ |
| extern double strtod (__const char *__restrict __nptr, |
| char **__restrict __endptr) |
| __THROW __nonnull ((1)) __wur; |
| __END_NAMESPACE_STD |
| |
| #ifdef __USE_ISOC99 |
| __BEGIN_NAMESPACE_C99 |
| /* Likewise for `float' and `long double' sizes of floating-point numbers. */ |
| extern float strtof (__const char *__restrict __nptr, |
| char **__restrict __endptr) __THROW __nonnull ((1)) __wur; |
| |
| extern long double strtold (__const char *__restrict __nptr, |
| char **__restrict __endptr) |
| __THROW __nonnull ((1)) __wur; |
| __END_NAMESPACE_C99 |
| #endif |
| |
| __BEGIN_NAMESPACE_STD |
| /* Convert a string to a long integer. */ |
| extern long int strtol (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base) |
| __THROW __nonnull ((1)) __wur; |
| /* Convert a string to an unsigned long integer. */ |
| extern unsigned long int strtoul (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base) |
| __THROW __nonnull ((1)) __wur; |
| __END_NAMESPACE_STD |
| |
| #if defined __GLIBC_HAVE_LONG_LONG && defined __USE_BSD |
| /* Convert a string to a quadword integer. */ |
| __extension__ |
| extern long long int strtoq (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base) |
| __THROW __nonnull ((1)) __wur; |
| /* Convert a string to an unsigned quadword integer. */ |
| __extension__ |
| extern unsigned long long int strtouq (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base) |
| __THROW __nonnull ((1)) __wur; |
| #endif /* GCC and use BSD. */ |
| |
| #if defined __USE_ISOC99 || (defined __GLIBC_HAVE_LONG_LONG && defined __USE_MISC) |
| __BEGIN_NAMESPACE_C99 |
| /* Convert a string to a quadword integer. */ |
| __extension__ |
| extern long long int strtoll (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base) |
| __THROW __nonnull ((1)) __wur; |
| /* Convert a string to an unsigned quadword integer. */ |
| __extension__ |
| extern unsigned long long int strtoull (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base) |
| __THROW __nonnull ((1)) __wur; |
| __END_NAMESPACE_C99 |
| #endif /* ISO C99 or GCC and use MISC. */ |
| |
| |
| #ifdef __USE_GNU |
| /* The concept of one static locale per category is not very well |
| thought out. Many applications will need to process its data using |
| information from several different locales. Another application is |
| the implementation of the internationalization handling in the |
| upcoming ISO C++ standard library. To support this another set of |
| the functions using locale data exist which have an additional |
| argument. |
| |
| Attention: all these functions are *not* standardized in any form. |
| This is a proof-of-concept implementation. */ |
| |
| /* Structure for reentrant locale using functions. This is an |
| (almost) opaque type for the user level programs. */ |
| # include <xlocale.h> |
| |
| /* Special versions of the functions above which take the locale to |
| use as an additional parameter. */ |
| extern long int strtol_l (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base, |
| __locale_t __loc) __THROW __nonnull ((1, 4)) __wur; |
| |
| extern unsigned long int strtoul_l (__const char *__restrict __nptr, |
| char **__restrict __endptr, |
| int __base, __locale_t __loc) |
| __THROW __nonnull ((1, 4)) __wur; |
| |
| __extension__ |
| extern long long int strtoll_l (__const char *__restrict __nptr, |
| char **__restrict __endptr, int __base, |
| __locale_t __loc) |
| __THROW __nonnull ((1, 4)) __wur; |
| |
| __extension__ |
| extern unsigned long long int strtoull_l (__const char *__restrict __nptr, |
| char **__restrict __endptr, |
| int __base, __locale_t __loc) |
| __THROW __nonnull ((1, 4)) __wur; |
| |
| extern double strtod_l (__const char *__restrict __nptr, |
| char **__restrict __endptr, __locale_t __loc) |
| __THROW __nonnull ((1, 3)) __wur; |
| |
| extern float strtof_l (__const char *__restrict __nptr, |
| char **__restrict __endptr, __locale_t __loc) |
| __THROW __nonnull ((1, 3)) __wur; |
| |
| extern long double strtold_l (__const char *__restrict __nptr, |
| char **__restrict __endptr, |
| __locale_t __loc) |
| __THROW __nonnull ((1, 3)) __wur; |
| #endif /* GNU */ |
| |
| |
| #ifdef __USE_EXTERN_INLINES |
| __BEGIN_NAMESPACE_STD |
| __extern_inline double |
| __NTH (atof (__const char *__nptr)) |
| { |
| return strtod (__nptr, (char **) NULL); |
| } |
| __extern_inline int |
| __NTH (atoi (__const char *__nptr)) |
| { |
| return (int) strtol (__nptr, (char **) NULL, 10); |
| } |
| __extern_inline long int |
| __NTH (atol (__const char *__nptr)) |
| { |
| return strtol (__nptr, (char **) NULL, 10); |
| } |
| __END_NAMESPACE_STD |
| |
| # if defined __USE_MISC || defined __USE_ISOC99 |
| __BEGIN_NAMESPACE_C99 |
| __extension__ __extern_inline long long int |
| __NTH (atoll (__const char *__nptr)) |
| { |
| return strtoll (__nptr, (char **) NULL, 10); |
| } |
| __END_NAMESPACE_C99 |
| # endif |
| #endif /* Optimizing and Inlining. */ |
| |
| |
| #if defined __USE_SVID || defined __USE_XOPEN_EXTENDED |
| /* Convert N to base 64 using the digits "./0-9A-Za-z", least-significant |
| digit first. Returns a pointer to static storage overwritten by the |
| next call. */ |
| extern char *l64a (long int __n) __THROW __wur; |
| |
| /* Read a number from a string S in base 64 as above. */ |
| extern long int a64l (__const char *__s) |
| __THROW __attribute_pure__ __nonnull ((1)) __wur; |
| |
| #endif /* Use SVID || extended X/Open. */ |
| |
| #if defined __USE_SVID || defined __USE_XOPEN_EXTENDED || defined __USE_BSD |
| # include <sys/types.h> /* we need int32_t... */ |
| |
| /* These are the functions that actually do things. The `random', `srandom', |
| `initstate' and `setstate' functions are those from BSD Unices. |
| The `rand' and `srand' functions are required by the ANSI standard. |
| We provide both interfaces to the same random number generator. */ |
| /* Return a random long integer between 0 and RAND_MAX inclusive. */ |
| extern long int random (void) __THROW; |
| |
| /* Seed the random number generator with the given number. */ |
| extern void srandom (unsigned int __seed) __THROW; |
| |
| /* Initialize the random number generator to use state buffer STATEBUF, |
| of length STATELEN, and seed it with SEED. Optimal lengths are 8, 16, |
| 32, 64, 128 and 256, the bigger the better; values less than 8 will |
| cause an error and values greater than 256 will be rounded down. */ |
| extern char *initstate (unsigned int __seed, char *__statebuf, |
| size_t __statelen) __THROW __nonnull ((2)); |
| |
| /* Switch the random number generator to state buffer STATEBUF, |
| which should have been previously initialized by `initstate'. */ |
| extern char *setstate (char *__statebuf) __THROW __nonnull ((1)); |
| |
| |
| # ifdef __USE_MISC |
| /* Reentrant versions of the `random' family of functions. |
| These functions all use the following data structure to contain |
| state, rather than global state variables. */ |
| |
| struct random_data |
| { |
| int32_t *fptr; /* Front pointer. */ |
| int32_t *rptr; /* Rear pointer. */ |
| int32_t *state; /* Array of state values. */ |
| int rand_type; /* Type of random number generator. */ |
| int rand_deg; /* Degree of random number generator. */ |
| int rand_sep; /* Distance between front and rear. */ |
| int32_t *end_ptr; /* Pointer behind state table. */ |
| }; |
| |
| extern int random_r (struct random_data *__restrict __buf, |
| int32_t *__restrict __result) __THROW __nonnull ((1, 2)); |
| |
| extern int srandom_r (unsigned int __seed, struct random_data *__buf) |
| __THROW __nonnull ((2)); |
| |
| extern int initstate_r (unsigned int __seed, char *__restrict __statebuf, |
| size_t __statelen, |
| struct random_data *__restrict __buf) |
| __THROW __nonnull ((2, 4)); |
| |
| extern int setstate_r (char *__restrict __statebuf, |
| struct random_data *__restrict __buf) |
| __THROW __nonnull ((1, 2)); |
| # endif /* Use misc. */ |
| #endif /* Use SVID || extended X/Open || BSD. */ |
| |
| |
| __BEGIN_NAMESPACE_STD |
| /* Return a random integer between 0 and RAND_MAX inclusive. */ |
| extern int rand (void) __THROW; |
| /* Seed the random number generator with the given number. */ |
| extern void srand (unsigned int __seed) __THROW; |
| __END_NAMESPACE_STD |
| |
| #ifdef __USE_POSIX |
| /* Reentrant interface according to POSIX.1. */ |
| extern int rand_r (unsigned int *__seed) __THROW; |
| #endif |
| |
| |
| #if defined __USE_SVID || defined __USE_XOPEN |
| /* System V style 48-bit random number generator functions. */ |
| |
| /* Return non-negative, double-precision floating-point value in [0.0,1.0). */ |
| extern double drand48 (void) __THROW; |
| extern double erand48 (unsigned short int __xsubi[3]) __THROW __nonnull ((1)); |
| |
| /* Return non-negative, long integer in [0,2^31). */ |
| extern long int lrand48 (void) __THROW; |
| extern long int nrand48 (unsigned short int __xsubi[3]) |
| __THROW __nonnull ((1)); |
| |
| /* Return signed, long integers in [-2^31,2^31). */ |
| extern long int mrand48 (void) __THROW; |
| extern long int jrand48 (unsigned short int __xsubi[3]) |
| __THROW __nonnull ((1)); |
| |
| /* Seed random number generator. */ |
| extern void srand48 (long int __seedval) __THROW; |
| extern unsigned short int *seed48 (unsigned short int __seed16v[3]) |
| __THROW __nonnull ((1)); |
| extern void lcong48 (unsigned short int __param[7]) __THROW __nonnull ((1)); |
| |
| # ifdef __USE_MISC |
| /* Data structure for communication with thread safe versions. This |
| type is to be regarded as opaque. It's only exported because users |
| have to allocate objects of this type. */ |
| struct drand48_data |
| { |
| unsigned short int __x[3]; /* Current state. */ |
| unsigned short int __old_x[3]; /* Old state. */ |
| unsigned short int __c; /* Additive const. in congruential formula. */ |
| unsigned short int __init; /* Flag for initializing. */ |
| unsigned long long int __a; /* Factor in congruential formula. */ |
| }; |
| |
| /* Return non-negative, double-precision floating-point value in [0.0,1.0). */ |
| extern int drand48_r (struct drand48_data *__restrict __buffer, |
| double *__restrict __result) __THROW __nonnull ((1, 2)); |
| extern int erand48_r (unsigned short int __xsubi[3], |
| struct drand48_data *__restrict __buffer, |
| double *__restrict __result) __THROW __nonnull ((1, 2)); |
| |
| /* Return non-negative, long integer in [0,2^31). */ |
| extern int lrand48_r (struct drand48_data *__restrict __buffer, |
| long int *__restrict __result) |
| __THROW __nonnull ((1, 2)); |
| extern int nrand48_r (unsigned short int __xsubi[3], |
| struct drand48_data *__restrict __buffer, |
| long int *__restrict __result) |
| __THROW __nonnull ((1, 2)); |
| |
| /* Return signed, long integers in [-2^31,2^31). */ |
| extern int mrand48_r (struct drand48_data *__restrict __buffer, |
| long int *__restrict __result) |
| __THROW __nonnull ((1, 2)); |
| extern int jrand48_r (unsigned short int __xsubi[3], |
| struct drand48_data *__restrict __buffer, |
| long int *__restrict __result) |
| __THROW __nonnull ((1, 2)); |
| |
| /* Seed random number generator. */ |
| extern int srand48_r (long int __seedval, struct drand48_data *__buffer) |
| __THROW __nonnull ((2)); |
| |
| extern int seed48_r (unsigned short int __seed16v[3], |
| struct drand48_data *__buffer) __THROW __nonnull ((1, 2)); |
| |
| extern int lcong48_r (unsigned short int __param[7], |
| struct drand48_data *__buffer) |
| __THROW __nonnull ((1, 2)); |
| # endif /* Use misc. */ |
| #endif /* Use SVID or X/Open. */ |
| |
| #endif /* don't just need malloc and calloc */ |
| |
| #ifndef __malloc_and_calloc_defined |
| # define __malloc_and_calloc_defined |
| __BEGIN_NAMESPACE_STD |
| /* Allocate SIZE bytes of memory. */ |
| extern void *malloc (size_t __size) __THROW __attribute_malloc__ __wur; |
| /* Allocate NMEMB elements of SIZE bytes each, all initialized to 0. */ |
| extern void *calloc (size_t __nmemb, size_t __size) |
| __THROW __attribute_malloc__ __wur; |
| __END_NAMESPACE_STD |
| #endif |
| |
| #ifndef __need_malloc_and_calloc |
| __BEGIN_NAMESPACE_STD |
| /* Re-allocate the previously allocated block |
| in PTR, making the new block SIZE bytes long. */ |
| /* __attribute_malloc__ is not used, because if realloc returns |
| the same pointer that was passed to it, aliasing needs to be allowed |
| between objects pointed by the old and new pointers. */ |
| extern void *realloc (void *__ptr, size_t __size) |
| __THROW __attribute_warn_unused_result__; |
| /* Free a block allocated by `malloc', `realloc' or `calloc'. */ |
| extern void free (void *__ptr) __THROW; |
| __END_NAMESPACE_STD |
| |
| #ifdef __USE_MISC |
| /* Free a block. An alias for `free'. (Sun Unices). */ |
| extern void cfree (void *__ptr) __THROW; |
| #endif /* Use misc. */ |
| |
| #if defined __USE_GNU || defined __USE_BSD || defined __USE_MISC |
| # include <alloca.h> |
| #endif /* Use GNU, BSD, or misc. */ |
| |
| #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED |
| /* Allocate SIZE bytes on a page boundary. The storage cannot be freed. */ |
| extern void *valloc (size_t __size) __THROW __attribute_malloc__ __wur; |
| #endif |
| |
| #ifdef __USE_XOPEN2K |
| /* Allocate memory of SIZE bytes with an alignment of ALIGNMENT. */ |
| extern int posix_memalign (void **__memptr, size_t __alignment, size_t __size) |
| __THROW __nonnull ((1)) __wur; |
| #endif |
| |
| __BEGIN_NAMESPACE_STD |
| /* Abort execution and generate a core-dump. */ |
| extern void abort (void) __THROW __attribute__ ((__noreturn__)); |
| |
| |
| /* Register a function to be called when `exit' is called. */ |
| extern int atexit (void (*__func) (void)) __THROW __nonnull ((1)); |
| __END_NAMESPACE_STD |
| |
| #ifdef __USE_MISC |
| /* Register a function to be called with the status |
| given to `exit' and the given argument. */ |
| extern int on_exit (void (*__func) (int __status, void *__arg), void *__arg) |
| __THROW __nonnull ((1)); |
| #endif |
| |
| __BEGIN_NAMESPACE_STD |
| /* Call all functions registered with `atexit' and `on_exit', |
| in the reverse of the order in which they were registered |
| perform stdio cleanup, and terminate program execution with STATUS. */ |
| extern void exit (int __status) __THROW __attribute__ ((__noreturn__)); |
| __END_NAMESPACE_STD |
| |
| #ifdef __USE_ISOC99 |
| __BEGIN_NAMESPACE_C99 |
| /* Terminate the program with STATUS without calling any of the |
| functions registered with `atexit' or `on_exit'. */ |
| extern void _Exit (int __status) __THROW __attribute__ ((__noreturn__)); |
| __END_NAMESPACE_C99 |
| #endif |
| |
| |
| __BEGIN_NAMESPACE_STD |
| /* Return the value of envariable NAME, or NULL if it doesn't exist. */ |
| extern char *getenv (__const char *__name) __THROW __nonnull ((1)) __wur; |
| __END_NAMESPACE_STD |
| |
| /* This function is similar to the above but returns NULL if the |
| programs is running with SUID or SGID enabled. */ |
| extern char *__secure_getenv (__const char *__name) |
| __THROW __nonnull ((1)) __wur; |
| |
| #if defined __USE_SVID || defined __USE_XOPEN |
| /* The SVID says this is in <stdio.h>, but this seems a better place. */ |
| /* Put STRING, which is of the form "NAME=VALUE", in the environment. |
| If there is no `=', remove NAME from the environment. */ |
| extern int putenv (char *__string) __THROW __nonnull ((1)); |
| #endif |
| |
| #if defined __USE_BSD || defined __USE_XOPEN2K |
| /* Set NAME to VALUE in the environment. |
| If REPLACE is nonzero, overwrite an existing value. */ |
| extern int setenv (__const char *__name, __const char *__value, int __replace) |
| __THROW __nonnull ((2)); |
| |
| /* Remove the variable NAME from the environment. */ |
| extern int unsetenv (__const char *__name) __THROW; |
| #endif |
| |
| #ifdef __USE_MISC |
| /* The `clearenv' was planned to be added to POSIX.1 but probably |
| never made it. Nevertheless the POSIX.9 standard (POSIX bindings |
| for Fortran 77) requires this function. */ |
| extern int clearenv (void) __THROW; |
| #endif |
| |
| |
| #if defined __USE_MISC || defined __USE_XOPEN_EXTENDED |
| /* Generate a unique temporary file name from TEMPLATE. |
| The last six characters of TEMPLATE must be "XXXXXX"; |
| they are replaced with a string that makes the file name unique. |
| Returns TEMPLATE, or a null pointer if it cannot get a unique file name. */ |
| extern char *mktemp (char *__template) __THROW __nonnull ((1)) __wur; |
| |
| /* Generate a unique temporary file name from TEMPLATE. |
| The last six characters of TEMPLATE must be "XXXXXX"; |
| they are replaced with a string that makes the filename unique. |
| Returns a file descriptor open on the file for reading and writing, |
| or -1 if it cannot create a uniquely-named file. |
| |
| This function is a possible cancellation points and therefore not |
| marked with __THROW. */ |
| # ifndef __USE_FILE_OFFSET64 |
| extern int mkstemp (char *__template) __nonnull ((1)) __wur; |
| # else |
| # ifdef __REDIRECT |
| extern int __REDIRECT (mkstemp, (char *__template), mkstemp64) |
| __nonnull ((1)) __wur; |
| # else |
| # define mkstemp mkstemp64 |
| # endif |
| # endif |
| # ifdef __USE_LARGEFILE64 |
| extern int mkstemp64 (char *__template) __nonnull ((1)) __wur; |
| # endif |
| #endif |
| |
| #ifdef __USE_BSD |
| /* Create a unique temporary directory from TEMPLATE. |
| The last six characters of TEMPLATE must be "XXXXXX"; |
| they are replaced with a string that makes the directory name unique. |
| Returns TEMPLATE, or a null pointer if it cannot get a unique name. |
| The directory is created mode 700. */ |
| extern char *mkdtemp (char *__template) __THROW __nonnull ((1)) __wur; |
| #endif |
| |
| #ifdef __USE_GNU |
| /* Generate a unique temporary file name from TEMPLATE similar to |
| mkstemp. But allow the caller to pass additional flags which are |
| used in the open call to create the file.. |
| |
| This function is a possible cancellation points and therefore not |
| marked with __THROW. */ |
| # ifndef __USE_FILE_OFFSET64 |
| extern int mkostemp (char *__template, int __flags) __nonnull ((1)) __wur; |
| # else |
| # ifdef __REDIRECT |
| extern int __REDIRECT (mkostemp, (char *__template, int __flags), mkostemp64) |
| __nonnull ((1)) __wur; |
| # else |
| # define mkostemp mkostemp64 |
| # endif |
| # endif |
| # ifdef __USE_LARGEFILE64 |
| extern int mkostemp64 (char *__template, int __flags) __nonnull ((1)) __wur; |
| # endif |
| #endif |
| |
| |
| __BEGIN_NAMESPACE_STD |
| /* Execute the given line as a shell command. |
| |
| This function is a cancellation point and therefore not marked with |
| __THROW. */ |
| extern int system (__const char *__command) __wur; |
| __END_NAMESPACE_STD |
| |
| |
| #ifdef __USE_GNU |
| /* Return a malloc'd string containing the canonical absolute name of the |
| existing named file. */ |
| extern char *canonicalize_file_name (__const char *__name) |
| __THROW __nonnull ((1)) __wur; |
| #endif |
| |
| #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED |
| /* Return the canonical absolute name of file NAME. If RESOLVED is |
| null, the result is malloc'd; otherwise, if the canonical name is |
| PATH_MAX chars or more, returns null with `errno' set to |
| ENAMETOOLONG; if the name fits in fewer than PATH_MAX chars, |
| returns the name in RESOLVED. */ |
| extern char *realpath (__const char *__restrict __name, |
| char *__restrict __resolved) __THROW __wur; |
| #endif |
| |
| |
| /* Shorthand for type of comparison functions. */ |
| #ifndef __COMPAR_FN_T |
| # define __COMPAR_FN_T |
| typedef int (*__compar_fn_t) (__const void *, __const void *); |
| |
| # ifdef __USE_GNU |
| typedef __compar_fn_t comparison_fn_t; |
| # endif |
| #endif |
| #ifdef __USE_GNU |
| typedef int (*__compar_d_fn_t) (__const void *, __const void *, void *); |
| #endif |
| |
| __BEGIN_NAMESPACE_STD |
| /* Do a binary search for KEY in BASE, which consists of NMEMB elements |
| of SIZE bytes each, using COMPAR to perform the comparisons. */ |
| extern void *bsearch (__const void *__key, __const void *__base, |
| size_t __nmemb, size_t __size, __compar_fn_t __compar) |
| __nonnull ((1, 2, 5)) __wur; |
| |
| /* Sort NMEMB elements of BASE, of SIZE bytes each, |
| using COMPAR to perform the comparisons. */ |
| extern void qsort (void *__base, size_t __nmemb, size_t __size, |
| __compar_fn_t __compar) __nonnull ((1, 4)); |
| #ifdef __USE_GNU |
| extern void qsort_r (void *__base, size_t __nmemb, size_t __size, |
| __compar_d_fn_t __compar, void *__arg) |
| __nonnull ((1, 4)); |
| #endif |
| |
| |
| /* Return the absolute value of X. */ |
| extern int abs (int __x) __THROW __attribute__ ((__const__)) __wur; |
| extern long int labs (long int __x) __THROW __attribute__ ((__const__)) __wur; |
| __END_NAMESPACE_STD |
| |
| #ifdef __USE_ISOC99 |
| __extension__ extern long long int llabs (long long int __x) |
| __THROW __attribute__ ((__const__)) __wur; |
| #endif |
| |
| |
| __BEGIN_NAMESPACE_STD |
| /* Return the `div_t', `ldiv_t' or `lldiv_t' representation |
| of the value of NUMER over DENOM. */ |
| /* GCC may have built-ins for these someday. */ |
| extern div_t div (int __numer, int __denom) |
| __THROW __attribute__ ((__const__)) __wur; |
| extern ldiv_t ldiv (long int __numer, long int __denom) |
| __THROW __attribute__ ((__const__)) __wur; |
| __END_NAMESPACE_STD |
| |
| #ifdef __USE_ISOC99 |
| __BEGIN_NAMESPACE_C99 |
| __extension__ extern lldiv_t lldiv (long long int __numer, |
| long long int __denom) |
| __THROW __attribute__ ((__const__)) __wur; |
| __END_NAMESPACE_C99 |
| #endif |
| |
| |
| #if defined __USE_SVID || defined __USE_XOPEN_EXTENDED |
| /* Convert floating point numbers to strings. The returned values are |
| valid only until another call to the same function. */ |
| |
| /* Convert VALUE to a string with NDIGIT digits and return a pointer to |
| this. Set *DECPT with the position of the decimal character and *SIGN |
| with the sign of the number. */ |
| extern char *ecvt (double __value, int __ndigit, int *__restrict __decpt, |
| int *__restrict __sign) __THROW __nonnull ((3, 4)) __wur; |
| |
| /* Convert VALUE to a string rounded to NDIGIT decimal digits. Set *DECPT |
| with the position of the decimal character and *SIGN with the sign of |
| the number. */ |
| extern char *fcvt (double __value, int __ndigit, int *__restrict __decpt, |
| int *__restrict __sign) __THROW __nonnull ((3, 4)) __wur; |
| |
| /* If possible convert VALUE to a string with NDIGIT significant digits. |
| Otherwise use exponential representation. The resulting string will |
| be written to BUF. */ |
| extern char *gcvt (double __value, int __ndigit, char *__buf) |
| __THROW __nonnull ((3)) __wur; |
| |
| |
| # ifdef __USE_MISC |
| /* Long double versions of above functions. */ |
| extern char *qecvt (long double __value, int __ndigit, |
| int *__restrict __decpt, int *__restrict __sign) |
| __THROW __nonnull ((3, 4)) __wur; |
| extern char *qfcvt (long double __value, int __ndigit, |
| int *__restrict __decpt, int *__restrict __sign) |
| __THROW __nonnull ((3, 4)) __wur; |
| extern char *qgcvt (long double __value, int __ndigit, char *__buf) |
| __THROW __nonnull ((3)) __wur; |
| |
| |
| /* Reentrant version of the functions above which provide their own |
| buffers. */ |
| extern int ecvt_r (double __value, int __ndigit, int *__restrict __decpt, |
| int *__restrict __sign, char *__restrict __buf, |
| size_t __len) __THROW __nonnull ((3, 4, 5)); |
| extern int fcvt_r (double __value, int __ndigit, int *__restrict __decpt, |
| int *__restrict __sign, char *__restrict __buf, |
| size_t __len) __THROW __nonnull ((3, 4, 5)); |
| |
| extern int qecvt_r (long double __value, int __ndigit, |
| int *__restrict __decpt, int *__restrict __sign, |
| char *__restrict __buf, size_t __len) |
| __THROW __nonnull ((3, 4, 5)); |
| extern int qfcvt_r (long double __value, int __ndigit, |
| int *__restrict __decpt, int *__restrict __sign, |
| char *__restrict __buf, size_t __len) |
| __THROW __nonnull ((3, 4, 5)); |
| # endif /* misc */ |
| #endif /* use MISC || use X/Open Unix */ |
| |
| |
| __BEGIN_NAMESPACE_STD |
| /* Return the length of the multibyte character |
| in S, which is no longer than N. */ |
| extern int mblen (__const char *__s, size_t __n) __THROW __wur; |
| /* Return the length of the given multibyte character, |
| putting its `wchar_t' representation in *PWC. */ |
| extern int mbtowc (wchar_t *__restrict __pwc, |
| __const char *__restrict __s, size_t __n) __THROW __wur; |
| /* Put the multibyte character represented |
| by WCHAR in S, returning its length. */ |
| extern int wctomb (char *__s, wchar_t __wchar) __THROW __wur; |
| |
| |
| /* Convert a multibyte string to a wide char string. */ |
| extern size_t mbstowcs (wchar_t *__restrict __pwcs, |
| __const char *__restrict __s, size_t __n) __THROW; |
| /* Convert a wide char string to multibyte string. */ |
| extern size_t wcstombs (char *__restrict __s, |
| __const wchar_t *__restrict __pwcs, size_t __n) |
| __THROW; |
| __END_NAMESPACE_STD |
| |
| |
| #ifdef __USE_SVID |
| /* Determine whether the string value of RESPONSE matches the affirmation |
| or negative response expression as specified by the LC_MESSAGES category |
| in the program's current locale. Returns 1 if affirmative, 0 if |
| negative, and -1 if not matching. */ |
| extern int rpmatch (__const char *__response) __THROW __nonnull ((1)) __wur; |
| #endif |
| |
| |
| #ifdef __USE_XOPEN_EXTENDED |
| /* Parse comma separated suboption from *OPTIONP and match against |
| strings in TOKENS. If found return index and set *VALUEP to |
| optional value introduced by an equal sign. If the suboption is |
| not part of TOKENS return in *VALUEP beginning of unknown |
| suboption. On exit *OPTIONP is set to the beginning of the next |
| token or at the terminating NUL character. */ |
| extern int getsubopt (char **__restrict __optionp, |
| char *__const *__restrict __tokens, |
| char **__restrict __valuep) |
| __THROW __nonnull ((1, 2, 3)) __wur; |
| #endif |
| |
| |
| #ifdef __USE_XOPEN |
| /* Setup DES tables according KEY. */ |
| extern void setkey (__const char *__key) __THROW __nonnull ((1)); |
| #endif |
| |
| |
| /* X/Open pseudo terminal handling. */ |
| |
| #ifdef __USE_XOPEN2K |
| /* Return a master pseudo-terminal handle. */ |
| extern int posix_openpt (int __oflag) __wur; |
| #endif |
| |
| #ifdef __USE_XOPEN |
| /* The next four functions all take a master pseudo-tty fd and |
| perform an operation on the associated slave: */ |
| |
| /* Chown the slave to the calling user. */ |
| extern int grantpt (int __fd) __THROW; |
| |
| /* Release an internal lock so the slave can be opened. |
| Call after grantpt(). */ |
| extern int unlockpt (int __fd) __THROW; |
| |
| /* Return the pathname of the pseudo terminal slave assoicated with |
| the master FD is open on, or NULL on errors. |
| The returned storage is good until the next call to this function. */ |
| extern char *ptsname (int __fd) __THROW __wur; |
| #endif |
| |
| #ifdef __USE_GNU |
| /* Store at most BUFLEN characters of the pathname of the slave pseudo |
| terminal associated with the master FD is open on in BUF. |
| Return 0 on success, otherwise an error number. */ |
| extern int ptsname_r (int __fd, char *__buf, size_t __buflen) |
| __THROW __nonnull ((2)); |
| |
| /* Open a master pseudo terminal and return its file descriptor. */ |
| extern int getpt (void); |
| #endif |
| |
| #ifdef __USE_BSD |
| /* Put the 1 minute, 5 minute and 15 minute load averages into the first |
| NELEM elements of LOADAVG. Return the number written (never more than |
| three, but may be less than NELEM), or -1 if an error occurred. */ |
| extern int getloadavg (double __loadavg[], int __nelem) |
| __THROW __nonnull ((1)); |
| #endif |
| |
| |
| /* Define some macros helping to catch buffer overflows. */ |
| #if __USE_FORTIFY_LEVEL > 0 && defined __extern_always_inline |
| # include <bits/stdlib.h> |
| #endif |
| #ifdef __LDBL_COMPAT |
| # include <bits/stdlib-ldbl.h> |
| #endif |
| |
| #endif /* don't just need malloc and calloc */ |
| #undef __need_malloc_and_calloc |
| |
| __END_DECLS |
| |
| #endif /* stdlib.h */ |