Libc-1044.40.1.tar.gz

[apple/libc.git] / include / stdlib.h

diff --git a/include/stdlib.h b/include/stdlib.h
index 08c9bc7e79887872feb183038ea2bba93e8ebab0..8530607d955342b80aef1692a225011a6495f8a0 100644 (file)
--- a/include/stdlib.h
+++ b/include/stdlib.h
@@ -1,10 +1,8 @@
 /*
 /*

- * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 2000, 2002 - 2008 Apple Inc. All rights reserved.

  *
  * @APPLE_LICENSE_HEADER_START@
  * 
  *
  * @APPLE_LICENSE_HEADER_START@
  * 

- * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
- * 

  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in
  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in


@@ -60,25 +58,26 @@
 #ifndef _STDLIB_H_
 #define _STDLIB_H_
 
 #ifndef _STDLIB_H_
 #define _STDLIB_H_
 

-#include <machine/ansi.h>
-#include <machine/types.h>
-
-#ifndef        _BSD_SIZE_T_DEFINED_
-#define        _BSD_SIZE_T_DEFINED_
-typedef        _BSD_SIZE_T_    size_t;
-#endif
+#include <Availability.h>

 
 

+#include <_types.h>

 #if !defined(_ANSI_SOURCE)
 #if !defined(_ANSI_SOURCE)

-#ifndef _BSD_RUNE_T_DEFINED_
-#define _BSD_RUNE_T_DEFINED_
-typedef _BSD_WCHAR_T_   rune_t;
-#endif
-#endif
+#include <sys/wait.h>
+#if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
+#include <alloca.h>
+#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
+#endif /* !_ANSI_SOURCE */

 
 

-#ifndef        _BSD_WCHAR_T_DEFINED_
-#define        _BSD_WCHAR_T_DEFINED_
-typedef        _BSD_WCHAR_T_   wchar_t;
-#endif
+/* DO NOT REMOVE THIS COMMENT: fixincludes needs to see:
+ * _GCC_SIZE_T */
+#include <sys/_types/_size_t.h>
+
+#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
+#include <sys/_types/_ct_rune_t.h>
+#include <sys/_types/_rune_t.h>
+#endif /* !_ANSI_SOURCE && (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
+
+#include <sys/_types/_wchar_t.h>

 
 typedef struct {
        int quot;               /* quotient */
 
 typedef struct {
        int quot;               /* quotient */


@@ -90,132 +89,305 @@ typedef struct {
        long rem;               /* remainder */
 } ldiv_t;
 
        long rem;               /* remainder */
 } ldiv_t;
 

-#ifndef NULL
-#define        NULL    0
-#endif
+#if !__DARWIN_NO_LONG_LONG
+typedef struct {
+       long long quot;
+       long long rem;
+} lldiv_t;
+#endif /* !__DARWIN_NO_LONG_LONG */
+
+#include <sys/_types/_null.h>

 
 #define        EXIT_FAILURE    1
 #define        EXIT_SUCCESS    0
 
 #define        RAND_MAX        0x7fffffff
 
 
 #define        EXIT_FAILURE    1
 #define        EXIT_SUCCESS    0
 
 #define        RAND_MAX        0x7fffffff
 

+#ifdef _USE_EXTENDED_LOCALES_
+#include <_xlocale.h>
+#endif /* _USE_EXTENDED_LOCALES_ */
+
+#ifndef MB_CUR_MAX
+#ifdef _USE_EXTENDED_LOCALES_
+#define        MB_CUR_MAX      (___mb_cur_max())
+#ifndef MB_CUR_MAX_L
+#define        MB_CUR_MAX_L(x) (___mb_cur_max_l(x))
+#endif /* !MB_CUR_MAX_L */
+#else /* !_USE_EXTENDED_LOCALES_ */

 extern int __mb_cur_max;
 #define        MB_CUR_MAX      __mb_cur_max
 extern int __mb_cur_max;
 #define        MB_CUR_MAX      __mb_cur_max

+#endif /* _USE_EXTENDED_LOCALES_ */
+#endif /* MB_CUR_MAX */

 
 

-#include <sys/cdefs.h>
+#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) \
+    && defined(_USE_EXTENDED_LOCALES_) && !defined(MB_CUR_MAX_L)
+#define        MB_CUR_MAX_L(x) (___mb_cur_max_l(x))
+#endif
+//Begin-Libc
+/* f must be a literal string */
+#define LIBC_ABORT(f,...)      abort_report_np("%s:%s:%u: " f, __FILE__, __func__, __LINE__, ## __VA_ARGS__)
+//End-Libc

 
 __BEGIN_DECLS
 
 __BEGIN_DECLS

-__dead void
-        abort __P((void));
-__pure int
-        abs __P((int));
-int     atexit __P((void (*)(void)));
-double  atof __P((const char *));
-int     atoi __P((const char *));
-long    atol __P((const char *));
-void   *bsearch __P((const void *, const void *, size_t,
-           size_t, int (*)(const void *, const void *)));
-void   *calloc __P((size_t, size_t));
-__pure div_t
-        div __P((int, int));
-__dead void
-        exit __P((int));
-void    free __P((void *));
-char   *getenv __P((const char *));
-__pure long
-        labs __P((long));
-__pure ldiv_t
-        ldiv __P((long, long));
-void   *malloc __P((size_t));
-void    qsort __P((void *, size_t, size_t,
-           int (*)(const void *, const void *)));
-int     rand __P((void));
-void   *realloc __P((void *, size_t));
-void    srand __P((unsigned));
-double  strtod __P((const char *, char **));
-long    strtol __P((const char *, char **, int));
+void    abort(void) __dead2;
+//Begin-Libc
+__attribute__((visibility("hidden")))
+void    abort_report_np(const char *, ...) __dead2 __printflike(1, 2);
+//End-Libc
+int     abs(int) __pure2;
+int     atexit(void (*)(void));
+double  atof(const char *);
+int     atoi(const char *);
+long    atol(const char *);
+#if !__DARWIN_NO_LONG_LONG
+long long
+        atoll(const char *);
+#endif /* !__DARWIN_NO_LONG_LONG */
+void   *bsearch(const void *, const void *, size_t,
+           size_t, int (*)(const void *, const void *));
+void   *calloc(size_t, size_t);
+div_t   div(int, int) __pure2;
+void    exit(int) __dead2;
+void    free(void *);
+char   *getenv(const char *);
+long    labs(long) __pure2;
+ldiv_t  ldiv(long, long) __pure2;
+#if !__DARWIN_NO_LONG_LONG
+long long
+        llabs(long long);
+lldiv_t         lldiv(long long, long long);
+#endif /* !__DARWIN_NO_LONG_LONG */
+void   *malloc(size_t);
+int     mblen(const char *, size_t);
+size_t  mbstowcs(wchar_t * __restrict , const char * __restrict, size_t);
+int     mbtowc(wchar_t * __restrict, const char * __restrict, size_t);
+int     posix_memalign(void **, size_t, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_0);
+void    qsort(void *, size_t, size_t,
+           int (*)(const void *, const void *));
+int     rand(void);
+void   *realloc(void *, size_t);
+void    srand(unsigned);
+double  strtod(const char *, char **) __DARWIN_ALIAS(strtod);
+float   strtof(const char *, char **) __DARWIN_ALIAS(strtof);
+long    strtol(const char *, char **, int);
+long double
+        strtold(const char *, char **);
+#if !__DARWIN_NO_LONG_LONG
+long long 
+        strtoll(const char *, char **, int);
+#endif /* !__DARWIN_NO_LONG_LONG */

 unsigned long
 unsigned long

-        strtoul __P((const char *, char **, int));
-int     system __P((const char *));
-
-/* These are currently just stubs. */
-int     mblen __P((const char *, size_t));
-size_t  mbstowcs __P((wchar_t *, const char *, size_t));
-int     wctomb __P((char *, wchar_t));
-int     mbtowc __P((wchar_t *, const char *, size_t));
-size_t  wcstombs __P((char *, const wchar_t *, size_t));
+        strtoul(const char *, char **, int);
+#if !__DARWIN_NO_LONG_LONG
+unsigned long long
+        strtoull(const char *, char **, int);
+#endif /* !__DARWIN_NO_LONG_LONG */
+//Begin-Libc
+#ifndef LIBC_ALIAS_SYSTEM
+//End-Libc
+int     system(const char *) __DARWIN_ALIAS_C(system) __OSX_AVAILABLE_BUT_DEPRECATED_MSG(__MAC_10_0,__MAC_NA,__IPHONE_2_0,__IPHONE_8_0, "Use posix_spawn APIs instead.");
+//Begin-Libc
+#else /* LIBC_ALIAS_SYSTEM */
+int     system(const char *) LIBC_ALIAS_C(system);
+#endif /* !LIBC_ALIAS_SYSTEM */
+//End-Libc
+size_t  wcstombs(char * __restrict, const wchar_t * __restrict, size_t);
+int     wctomb(char *, wchar_t);

 
 #ifndef _ANSI_SOURCE
 
 #ifndef _ANSI_SOURCE

-int     putenv __P((const char *));
-int     setenv __P((const char *, const char *, int));
-#endif
-
-#if !defined(_ANSI_SOURCE) && !defined(_POSIX_SOURCE)
-double drand48 __P((void));
-double erand48 __P((unsigned short[3])); 
-long   jrand48 __P((unsigned short[3]));
-void   lcong48 __P((unsigned short[7]));
-long   lrand48 __P((void));
-long   mrand48 __P((void)); 
-long   nrand48 __P((unsigned short[3]));
+void   _Exit(int) __dead2;
+long    a64l(const char *);
+double  drand48(void);
+char   *ecvt(double, int, int *__restrict, int *__restrict); /* LEGACY */
+double  erand48(unsigned short[3]); 
+char   *fcvt(double, int, int *__restrict, int *__restrict); /* LEGACY */
+char   *gcvt(double, int, char *); /* LEGACY */
+int     getsubopt(char **, char * const *, char **);
+int     grantpt(int);
+#if __DARWIN_UNIX03
+char   *initstate(unsigned, char *, size_t); /* no  __DARWIN_ALIAS needed */
+#else /* !__DARWIN_UNIX03 */
+char   *initstate(unsigned long, char *, long);
+#endif /* __DARWIN_UNIX03 */
+long    jrand48(unsigned short[3]);
+char   *l64a(long);
+void    lcong48(unsigned short[7]);
+long    lrand48(void);
+char   *mktemp(char *);
+int     mkstemp(char *);
+long    mrand48(void); 
+long    nrand48(unsigned short[3]);
+int     posix_openpt(int);
+char   *ptsname(int);
+//Begin-Libc
+#ifndef LIBC_ALIAS_PUTENV
+//End-Libc
+int     putenv(char *) __DARWIN_ALIAS(putenv);
+//Begin-Libc
+#else /* LIBC_ALIAS_PUTENV */
+int     putenv(char *) LIBC_ALIAS(putenv);
+#endif /* !LIBC_ALIAS_PUTENV */
+//End-Libc
+long    random(void);
+int     rand_r(unsigned *);
+//Begin-Libc
+#ifdef __LIBC__
+#ifndef LIBC_ALIAS_REALPATH
+char   *realpath(const char * __restrict, char * __restrict) __DARWIN_EXTSN(realpath);
+#else /* LIBC_ALIAS_REALPATH */
+#ifdef VARIANT_DARWINEXTSN
+char   *realpath(const char * __restrict, char * __restrict) LIBC_EXTSN(realpath);
+#else /* !VARIANT_DARWINEXTSN */
+char   *realpath(const char * __restrict, char * __restrict) LIBC_ALIAS(realpath);
+#endif /* VARIANT_DARWINEXTSN */
+#endif /* !LIBC_ALIAS_REALPATH */
+#else /* !__LIBC__ */
+//End-Libc
+#if (__DARWIN_UNIX03 && !defined(_POSIX_C_SOURCE)) || defined(_DARWIN_C_SOURCE) || defined(_DARWIN_BETTER_REALPATH)
+char   *realpath(const char * __restrict, char * __restrict) __DARWIN_EXTSN(realpath);
+#else /* (!__DARWIN_UNIX03 || _POSIX_C_SOURCE) && !_DARWIN_C_SOURCE && !_DARWIN_BETTER_REALPATH */
+char   *realpath(const char * __restrict, char * __restrict) __DARWIN_ALIAS(realpath);
+#endif /* (__DARWIN_UNIX03 && _POSIX_C_SOURCE) || _DARWIN_C_SOURCE || _DARWIN_BETTER_REALPATH */
+//Begin-Libc
+#endif /* __LIBC__ */
+//End-Libc

 unsigned short
 unsigned short

-       *seed48 __P((unsigned short[3]));
-void   srand48 __P((long));
+       *seed48(unsigned short[3]);
+//Begin-Libc
+#ifndef LIBC_ALIAS_SETENV
+//End-Libc
+int     setenv(const char *, const char *, int) __DARWIN_ALIAS(setenv);
+//Begin-Libc
+#else /* LIBC_ALIAS_SETENV */
+int     setenv(const char *, const char *, int) LIBC_ALIAS(setenv);
+#endif /* !LIBC_ALIAS_SETENV */
+//End-Libc
+#if __DARWIN_UNIX03
+//Begin-Libc
+#ifndef LIBC_ALIAS_SETKEY
+//End-Libc
+void    setkey(const char *) __DARWIN_ALIAS(setkey);
+//Begin-Libc
+#else /* LIBC_ALIAS_SETKEY */
+void    setkey(const char *) LIBC_ALIAS(setkey);
+#endif /* !LIBC_ALIAS_SETKEY */
+//End-Libc
+#else /* !__DARWIN_UNIX03 */
+int     setkey(const char *);
+#endif /* __DARWIN_UNIX03 */
+char   *setstate(const char *);
+void    srand48(long);
+#if __DARWIN_UNIX03
+void    srandom(unsigned);
+#else /* !__DARWIN_UNIX03 */
+void    srandom(unsigned long);
+#endif /* __DARWIN_UNIX03 */
+int     unlockpt(int);
+#if __DARWIN_UNIX03
+//Begin-Libc
+#ifndef LIBC_ALIAS_UNSETENV
+//End-Libc
+int     unsetenv(const char *) __DARWIN_ALIAS(unsetenv);
+//Begin-Libc
+#else /* LIBC_ALIAS_UNSETENV */
+int     unsetenv(const char *) LIBC_ALIAS(unsetenv);
+#endif /* !LIBC_ALIAS_UNSETENV */
+//End-Libc
+#else /* !__DARWIN_UNIX03 */
+void    unsetenv(const char *);
+#endif /* __DARWIN_UNIX03 */
+#endif /* !_ANSI_SOURCE */

 
 

-void   *alloca __P((size_t));          /* built-in for gcc */
-                                       /* getcap(3) functions */
+#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
+#include <machine/types.h>
+
+#include <sys/_types/_dev_t.h>
+#include <sys/_types/_mode_t.h>
+
+u_int32_t      arc4random(void);
+void    arc4random_addrandom(unsigned char * /*dat*/, int /*datlen*/);
+void    arc4random_buf(void * /*buf*/, size_t /*nbytes*/) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
+void    arc4random_stir(void);

 u_int32_t
 u_int32_t

-        arc4random __P((void));
-void    arc4random_addrandom __P((unsigned char *dat, int datlen));
-void    arc4random_stir __P((void));
-char   *getbsize __P((int *, long *));
-char   *cgetcap __P((char *, char *, int));
-int     cgetclose __P((void));
-int     cgetent __P((char **, char **, char *));
-int     cgetfirst __P((char **, char **));
-int     cgetmatch __P((char *, char *));
-int     cgetnext __P((char **, char **));
-int     cgetnum __P((char *, char *, long *));
-int     cgetset __P((char *));
-int     cgetstr __P((char *, char *, char **));
-int     cgetustr __P((char *, char *, char **));
-
-int     daemon __P((int, int));
-char   *devname __P((int, int));
-int     getloadavg __P((double [], int));
-
-long    a64l __P((const char *));
-char   *l64a __P((long));
-
-char   *group_from_gid __P((unsigned long, int));
-int     heapsort __P((void *, size_t, size_t,
-           int (*)(const void *, const void *)));
-char   *initstate __P((unsigned long, char *, long));
-int     mergesort __P((void *, size_t, size_t,
-           int (*)(const void *, const void *)));
-int     radixsort __P((const unsigned char **, int, const unsigned char *,
-           unsigned));
-int     sradixsort __P((const unsigned char **, int, const unsigned char *,
-           unsigned));
-int     rand_r __P((unsigned *));
-long    random __P((void));
-void   *reallocf __P((void *, size_t));
-char   *realpath __P((const char *, char resolved_path[]));
-char   *setstate __P((char *));
-void    srandom __P((unsigned long));
-char   *user_from_uid __P((unsigned long, int));
-#ifndef __STRICT_ANSI__
-long long 
-        strtoll(const char *, char **, int);
-unsigned long long
-        strtoull(const char *, char **, int);
+        arc4random_uniform(u_int32_t /*upper_bound*/) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
+#ifdef __BLOCKS__
+int     atexit_b(void (^)(void)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+void   *bsearch_b(const void *, const void *, size_t,
+           size_t, int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+#endif /* __BLOCKS__ */
+
+        /* getcap(3) functions */
+char   *cgetcap(char *, const char *, int);
+int     cgetclose(void);
+int     cgetent(char **, char **, const char *);
+int     cgetfirst(char **, char **);
+int     cgetmatch(const char *, const char *);
+int     cgetnext(char **, char **);
+int     cgetnum(char *, const char *, long *);
+int     cgetset(const char *);
+int     cgetstr(char *, const char *, char **);
+int     cgetustr(char *, const char *, char **);
+
+int     daemon(int, int) __DARWIN_1050(daemon) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_5, __IPHONE_2_0, __IPHONE_2_0);
+char   *devname(dev_t, mode_t);
+char   *devname_r(dev_t, mode_t, char *buf, int len);
+char   *getbsize(int *, long *);
+int     getloadavg(double [], int);
+const char
+       *getprogname(void);
+
+int     heapsort(void *, size_t, size_t,
+           int (*)(const void *, const void *));
+#ifdef __BLOCKS__
+int     heapsort_b(void *, size_t, size_t,
+           int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+#endif /* __BLOCKS__ */
+int     mergesort(void *, size_t, size_t,
+           int (*)(const void *, const void *));
+#ifdef __BLOCKS__
+int     mergesort_b(void *, size_t, size_t,
+           int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+#endif /* __BLOCKS__ */
+void    psort(void *, size_t, size_t,
+           int (*)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+#ifdef __BLOCKS__
+void    psort_b(void *, size_t, size_t,
+           int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+#endif /* __BLOCKS__ */
+void    psort_r(void *, size_t, size_t, void *,
+           int (*)(void *, const void *, const void *))  __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+#ifdef __BLOCKS__
+void    qsort_b(void *, size_t, size_t,
+           int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
+#endif /* __BLOCKS__ */
+void    qsort_r(void *, size_t, size_t, void *,
+           int (*)(void *, const void *, const void *));
+int     radixsort(const unsigned char **, int, const unsigned char *,
+           unsigned);
+void    setprogname(const char *);
+int     sradixsort(const unsigned char **, int, const unsigned char *,
+           unsigned);
+void    sranddev(void);
+void    srandomdev(void);
+void   *reallocf(void *, size_t);
+#if !__DARWIN_NO_LONG_LONG

 long long
 long long

-        strtoq __P((const char *, char **, int));
+        strtoq(const char *, char **, int);

 unsigned long long
 unsigned long long

-        strtouq __P((const char *, char **, int));
-#endif
-void    unsetenv __P((const char *));
+        strtouq(const char *, char **, int);
+#endif /* !__DARWIN_NO_LONG_LONG */
+extern char *suboptarg;                /* getsubopt(3) external variable */
+void   *valloc(size_t);
+#endif /* !_ANSI_SOURCE && !_POSIX_SOURCE */
+
+/* Poison the following routines if -fshort-wchar is set */
+#if !defined(__cplusplus) && defined(__WCHAR_MAX__) && __WCHAR_MAX__ <= 0xffffU
+#pragma GCC poison mbstowcs mbtowc wcstombs wctomb

 #endif
 __END_DECLS
 
 #endif
 __END_DECLS
 

+#ifdef _USE_EXTENDED_LOCALES_
+#include <xlocale/_stdlib.h>
+#endif /* _USE_EXTENDED_LOCALES_ */
+

 #endif /* _STDLIB_H_ */
 #endif /* _STDLIB_H_ */