]> git.saurik.com Git - apple/libc.git/blame - include/stdlib.h
Libc-825.40.1.tar.gz
[apple/libc.git] / include / stdlib.h
CommitLineData
5b2abdfb 1/*
b5d655f7 2 * Copyright (c) 2000, 2002 - 2008 Apple Inc. All rights reserved.
5b2abdfb
A
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
734aad71
A
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
5b2abdfb
A
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
734aad71
A
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
5b2abdfb
A
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23/*-
24 * Copyright (c) 1990, 1993
25 * The Regents of the University of California. All rights reserved.
26 *
27 * Redistribution and use in source and binary forms, with or without
28 * modification, are permitted provided that the following conditions
29 * are met:
30 * 1. Redistributions of source code must retain the above copyright
31 * notice, this list of conditions and the following disclaimer.
32 * 2. Redistributions in binary form must reproduce the above copyright
33 * notice, this list of conditions and the following disclaimer in the
34 * documentation and/or other materials provided with the distribution.
35 * 3. All advertising materials mentioning features or use of this software
36 * must display the following acknowledgement:
37 * This product includes software developed by the University of
38 * California, Berkeley and its contributors.
39 * 4. Neither the name of the University nor the names of its contributors
40 * may be used to endorse or promote products derived from this software
41 * without specific prior written permission.
42 *
43 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
47 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
48 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
49 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
50 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
51 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
52 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53 * SUCH DAMAGE.
54 *
55 * @(#)stdlib.h 8.5 (Berkeley) 5/19/95
56 */
57
58#ifndef _STDLIB_H_
59#define _STDLIB_H_
60
b5d655f7 61#include <Availability.h>
224c7076 62
3d9156a7
A
63#include <_types.h>
64#if !defined(_ANSI_SOURCE)
65#include <sys/wait.h>
224c7076 66#if (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
9385eb3d 67#include <alloca.h>
224c7076 68#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
3d9156a7 69#endif /* !_ANSI_SOURCE */
5b2abdfb 70
3d9156a7
A
71#ifndef _SIZE_T
72#define _SIZE_T
73/* DO NOT REMOVE THIS COMMENT: fixincludes needs to see:
74 * _GCC_SIZE_T */
75typedef __darwin_size_t size_t;
5b2abdfb
A
76#endif
77
224c7076 78#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
3d9156a7
A
79#ifndef _CT_RUNE_T
80#define _CT_RUNE_T
81typedef __darwin_ct_rune_t ct_rune_t;
9385eb3d
A
82#endif
83
3d9156a7
A
84#ifndef _RUNE_T
85#define _RUNE_T
86typedef __darwin_rune_t rune_t;
5b2abdfb 87#endif
224c7076 88#endif /* !_ANSI_SOURCE && (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
5b2abdfb 89
9385eb3d 90#ifndef __cplusplus
3d9156a7
A
91#ifndef _WCHAR_T
92#define _WCHAR_T
93typedef __darwin_wchar_t wchar_t;
94#endif /* _WCHAR_T */
9385eb3d
A
95#endif /* __cplusplus */
96
5b2abdfb
A
97typedef struct {
98 int quot; /* quotient */
99 int rem; /* remainder */
100} div_t;
101
102typedef struct {
103 long quot; /* quotient */
104 long rem; /* remainder */
105} ldiv_t;
106
3d9156a7
A
107#if !__DARWIN_NO_LONG_LONG
108typedef struct {
109 long long quot;
110 long long rem;
111} lldiv_t;
112#endif /* !__DARWIN_NO_LONG_LONG */
113
5b2abdfb 114#ifndef NULL
3d9156a7 115#define NULL __DARWIN_NULL
59e0d9fe 116#endif /* ! NULL */
5b2abdfb
A
117
118#define EXIT_FAILURE 1
119#define EXIT_SUCCESS 0
120
121#define RAND_MAX 0x7fffffff
122
3d9156a7
A
123#ifdef _USE_EXTENDED_LOCALES_
124#include <_xlocale.h>
125#endif /* _USE_EXTENDED_LOCALES_ */
126
127#ifndef MB_CUR_MAX
128#ifdef _USE_EXTENDED_LOCALES_
129#define MB_CUR_MAX (___mb_cur_max())
130#ifndef MB_CUR_MAX_L
131#define MB_CUR_MAX_L(x) (___mb_cur_max_l(x))
132#endif /* !MB_CUR_MAX_L */
133#else /* !_USE_EXTENDED_LOCALES_ */
5b2abdfb
A
134extern int __mb_cur_max;
135#define MB_CUR_MAX __mb_cur_max
3d9156a7
A
136#endif /* _USE_EXTENDED_LOCALES_ */
137#endif /* MB_CUR_MAX */
5b2abdfb 138
224c7076 139#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) \
3d9156a7
A
140 && defined(_USE_EXTENDED_LOCALES_) && !defined(MB_CUR_MAX_L)
141#define MB_CUR_MAX_L(x) (___mb_cur_max_l(x))
142#endif
34e8f829
A
143//Begin-Libc
144/* f must be a literal string */
145#define LIBC_ABORT(f,...) abort_report_np("%s:%s:%u: " f, __FILE__, __func__, __LINE__, ## __VA_ARGS__)
146//End-Libc
5b2abdfb
A
147
148__BEGIN_DECLS
9385eb3d 149void abort(void) __dead2;
34e8f829
A
150//Begin-Libc
151__private_extern__
152void abort_report_np(const char *, ...) __dead2 __printflike(1, 2);
153//End-Libc
9385eb3d
A
154int abs(int) __pure2;
155int atexit(void (*)(void));
156double atof(const char *);
157int atoi(const char *);
158long atol(const char *);
3d9156a7
A
159#if !__DARWIN_NO_LONG_LONG
160long long
161 atoll(const char *);
162#endif /* !__DARWIN_NO_LONG_LONG */
9385eb3d
A
163void *bsearch(const void *, const void *, size_t,
164 size_t, int (*)(const void *, const void *));
165void *calloc(size_t, size_t);
166div_t div(int, int) __pure2;
167void exit(int) __dead2;
168void free(void *);
169char *getenv(const char *);
170long labs(long) __pure2;
171ldiv_t ldiv(long, long) __pure2;
3d9156a7
A
172#if !__DARWIN_NO_LONG_LONG
173long long
174 llabs(long long);
175lldiv_t lldiv(long long, long long);
176#endif /* !__DARWIN_NO_LONG_LONG */
9385eb3d
A
177void *malloc(size_t);
178int mblen(const char *, size_t);
179size_t mbstowcs(wchar_t * __restrict , const char * __restrict, size_t);
180int mbtowc(wchar_t * __restrict, const char * __restrict, size_t);
1f2f436a 181int posix_memalign(void **, size_t, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_0);
9385eb3d
A
182void qsort(void *, size_t, size_t,
183 int (*)(const void *, const void *));
184int rand(void);
185void *realloc(void *, size_t);
186void srand(unsigned);
224c7076
A
187double strtod(const char *, char **) __DARWIN_ALIAS(strtod);
188float strtof(const char *, char **) __DARWIN_ALIAS(strtof);
9385eb3d
A
189long strtol(const char *, char **, int);
190long double
ad3c9f2a 191 strtold(const char *, char **);
3d9156a7
A
192#if !__DARWIN_NO_LONG_LONG
193long long
194 strtoll(const char *, char **, int);
195#endif /* !__DARWIN_NO_LONG_LONG */
5b2abdfb 196unsigned long
9385eb3d 197 strtoul(const char *, char **, int);
3d9156a7
A
198#if !__DARWIN_NO_LONG_LONG
199unsigned long long
200 strtoull(const char *, char **, int);
201#endif /* !__DARWIN_NO_LONG_LONG */
224c7076
A
202//Begin-Libc
203#ifndef LIBC_ALIAS_SYSTEM
204//End-Libc
205int system(const char *) __DARWIN_ALIAS_C(system);
206//Begin-Libc
207#else /* LIBC_ALIAS_SYSTEM */
208int system(const char *) LIBC_ALIAS_C(system);
209#endif /* !LIBC_ALIAS_SYSTEM */
210//End-Libc
9385eb3d 211size_t wcstombs(char * __restrict, const wchar_t * __restrict, size_t);
3d9156a7 212int wctomb(char *, wchar_t);
5b2abdfb
A
213
214#ifndef _ANSI_SOURCE
3d9156a7
A
215void _Exit(int) __dead2;
216long a64l(const char *);
9385eb3d 217double drand48(void);
3d9156a7 218char *ecvt(double, int, int *__restrict, int *__restrict); /* LEGACY */
9385eb3d 219double erand48(unsigned short[3]);
3d9156a7
A
220char *fcvt(double, int, int *__restrict, int *__restrict); /* LEGACY */
221char *gcvt(double, int, char *); /* LEGACY */
222int getsubopt(char **, char * const *, char **);
223int grantpt(int);
224#if __DARWIN_UNIX03
225char *initstate(unsigned, char *, size_t); /* no __DARWIN_ALIAS needed */
226#else /* !__DARWIN_UNIX03 */
227char *initstate(unsigned long, char *, long);
228#endif /* __DARWIN_UNIX03 */
9385eb3d 229long jrand48(unsigned short[3]);
3d9156a7 230char *l64a(long);
9385eb3d
A
231void lcong48(unsigned short[7]);
232long lrand48(void);
3d9156a7
A
233char *mktemp(char *);
234int mkstemp(char *);
9385eb3d
A
235long mrand48(void);
236long nrand48(unsigned short[3]);
3d9156a7
A
237int posix_openpt(int);
238char *ptsname(int);
224c7076
A
239//Begin-Libc
240#ifndef LIBC_ALIAS_PUTENV
241//End-Libc
3d9156a7 242int putenv(char *) __DARWIN_ALIAS(putenv);
224c7076
A
243//Begin-Libc
244#else /* LIBC_ALIAS_PUTENV */
245int putenv(char *) LIBC_ALIAS(putenv);
246#endif /* !LIBC_ALIAS_PUTENV */
247//End-Libc
3d9156a7 248long random(void);
224c7076
A
249int rand_r(unsigned *);
250//Begin-Libc
251#ifdef __LIBC__
252#ifndef LIBC_ALIAS_REALPATH
253char *realpath(const char * __restrict, char * __restrict) __DARWIN_EXTSN(realpath);
254#else /* LIBC_ALIAS_REALPATH */
255#ifdef VARIANT_DARWINEXTSN
256char *realpath(const char * __restrict, char * __restrict) LIBC_EXTSN(realpath);
257#else /* !VARIANT_DARWINEXTSN */
258char *realpath(const char * __restrict, char * __restrict) LIBC_ALIAS(realpath);
259#endif /* VARIANT_DARWINEXTSN */
260#endif /* !LIBC_ALIAS_REALPATH */
261#else /* !__LIBC__ */
262//End-Libc
263#if (__DARWIN_UNIX03 && !defined(_POSIX_C_SOURCE)) || defined(_DARWIN_C_SOURCE) || defined(_DARWIN_BETTER_REALPATH)
264char *realpath(const char * __restrict, char * __restrict) __DARWIN_EXTSN(realpath);
265#else /* (!__DARWIN_UNIX03 || _POSIX_C_SOURCE) && !_DARWIN_C_SOURCE && !_DARWIN_BETTER_REALPATH */
266char *realpath(const char * __restrict, char * __restrict) __DARWIN_ALIAS(realpath);
267#endif /* (__DARWIN_UNIX03 && _POSIX_C_SOURCE) || _DARWIN_C_SOURCE || _DARWIN_BETTER_REALPATH */
268//Begin-Libc
269#endif /* __LIBC__ */
270//End-Libc
9385eb3d
A
271unsigned short
272 *seed48(unsigned short[3]);
224c7076
A
273//Begin-Libc
274#ifndef LIBC_ALIAS_SETENV
275//End-Libc
3d9156a7 276int setenv(const char *, const char *, int) __DARWIN_ALIAS(setenv);
224c7076
A
277//Begin-Libc
278#else /* LIBC_ALIAS_SETENV */
279int setenv(const char *, const char *, int) LIBC_ALIAS(setenv);
280#endif /* !LIBC_ALIAS_SETENV */
281//End-Libc
3d9156a7 282#if __DARWIN_UNIX03
224c7076
A
283//Begin-Libc
284#ifndef LIBC_ALIAS_SETKEY
285//End-Libc
3d9156a7 286void setkey(const char *) __DARWIN_ALIAS(setkey);
224c7076
A
287//Begin-Libc
288#else /* LIBC_ALIAS_SETKEY */
289void setkey(const char *) LIBC_ALIAS(setkey);
290#endif /* !LIBC_ALIAS_SETKEY */
291//End-Libc
3d9156a7
A
292#else /* !__DARWIN_UNIX03 */
293int setkey(const char *);
294#endif /* __DARWIN_UNIX03 */
295char *setstate(const char *);
9385eb3d 296void srand48(long);
3d9156a7
A
297#if __DARWIN_UNIX03
298void srandom(unsigned);
299#else /* !__DARWIN_UNIX03 */
300void srandom(unsigned long);
301#endif /* __DARWIN_UNIX03 */
302int unlockpt(int);
303#if __DARWIN_UNIX03
224c7076
A
304//Begin-Libc
305#ifndef LIBC_ALIAS_UNSETENV
306//End-Libc
3d9156a7 307int unsetenv(const char *) __DARWIN_ALIAS(unsetenv);
224c7076
A
308//Begin-Libc
309#else /* LIBC_ALIAS_UNSETENV */
310int unsetenv(const char *) LIBC_ALIAS(unsetenv);
311#endif /* !LIBC_ALIAS_UNSETENV */
312//End-Libc
3d9156a7
A
313#else /* !__DARWIN_UNIX03 */
314void unsetenv(const char *);
315#endif /* __DARWIN_UNIX03 */
224c7076 316#endif /* !_ANSI_SOURCE */
3d9156a7 317
224c7076 318#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
3d9156a7
A
319#include <machine/types.h>
320
321#ifndef _DEV_T
322typedef __darwin_dev_t dev_t;
323#define _DEV_T
324#endif
325
326#ifndef _MODE_T
327typedef __darwin_mode_t mode_t;
328#define _MODE_T
329#endif
330
331u_int32_t
332 arc4random(void);
1f2f436a
A
333void arc4random_addrandom(unsigned char * /*dat*/, int /*datlen*/);
334void arc4random_buf(void * /*buf*/, size_t /*nbytes*/) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
3d9156a7 335void arc4random_stir(void);
1f2f436a
A
336u_int32_t
337 arc4random_uniform(u_int32_t /*upper_bound*/) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
34e8f829 338#ifdef __BLOCKS__
1f2f436a 339int atexit_b(void (^)(void)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829 340void *bsearch_b(const void *, const void *, size_t,
1f2f436a 341 size_t, int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829 342#endif /* __BLOCKS__ */
9385eb3d
A
343
344 /* getcap(3) functions */
345char *cgetcap(char *, const char *, int);
346int cgetclose(void);
347int cgetent(char **, char **, const char *);
348int cgetfirst(char **, char **);
349int cgetmatch(const char *, const char *);
350int cgetnext(char **, char **);
351int cgetnum(char *, const char *, long *);
352int cgetset(const char *);
353int cgetstr(char *, const char *, char **);
354int cgetustr(char *, const char *, char **);
355
1f2f436a 356int daemon(int, int) __DARWIN_1050(daemon) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_5, __IPHONE_2_0, __IPHONE_2_0);
3d9156a7
A
357char *devname(dev_t, mode_t);
358char *devname_r(dev_t, mode_t, char *buf, int len);
9385eb3d
A
359char *getbsize(int *, long *);
360int getloadavg(double [], int);
361const char
362 *getprogname(void);
363
9385eb3d
A
364int heapsort(void *, size_t, size_t,
365 int (*)(const void *, const void *));
34e8f829
A
366#ifdef __BLOCKS__
367int heapsort_b(void *, size_t, size_t,
1f2f436a 368 int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829 369#endif /* __BLOCKS__ */
9385eb3d
A
370int mergesort(void *, size_t, size_t,
371 int (*)(const void *, const void *));
34e8f829
A
372#ifdef __BLOCKS__
373int mergesort_b(void *, size_t, size_t,
1f2f436a 374 int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829
A
375#endif /* __BLOCKS__ */
376void psort(void *, size_t, size_t,
1f2f436a 377 int (*)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829
A
378#ifdef __BLOCKS__
379void psort_b(void *, size_t, size_t,
1f2f436a 380 int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829
A
381#endif /* __BLOCKS__ */
382void psort_r(void *, size_t, size_t, void *,
1f2f436a 383 int (*)(void *, const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829
A
384#ifdef __BLOCKS__
385void qsort_b(void *, size_t, size_t,
1f2f436a 386 int (^)(const void *, const void *)) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_2);
34e8f829 387#endif /* __BLOCKS__ */
9385eb3d
A
388void qsort_r(void *, size_t, size_t, void *,
389 int (*)(void *, const void *, const void *));
390int radixsort(const unsigned char **, int, const unsigned char *,
391 unsigned);
392void setprogname(const char *);
393int sradixsort(const unsigned char **, int, const unsigned char *,
394 unsigned);
395void sranddev(void);
396void srandomdev(void);
9385eb3d 397void *reallocf(void *, size_t);
3d9156a7 398#if !__DARWIN_NO_LONG_LONG
5b2abdfb 399long long
9385eb3d 400 strtoq(const char *, char **, int);
5b2abdfb 401unsigned long long
9385eb3d 402 strtouq(const char *, char **, int);
3d9156a7
A
403#endif /* !__DARWIN_NO_LONG_LONG */
404extern char *suboptarg; /* getsubopt(3) external variable */
405void *valloc(size_t);
224c7076
A
406#endif /* !_ANSI_SOURCE && !_POSIX_SOURCE */
407
408/* Poison the following routines if -fshort-wchar is set */
409#if !defined(__cplusplus) && defined(__WCHAR_MAX__) && __WCHAR_MAX__ <= 0xffffU
410#pragma GCC poison mbstowcs mbtowc wcstombs wctomb
5b2abdfb
A
411#endif
412__END_DECLS
413
3d9156a7
A
414#ifdef _USE_EXTENDED_LOCALES_
415#include <xlocale/_stdlib.h>
416#endif /* _USE_EXTENDED_LOCALES_ */
417
5b2abdfb 418#endif /* _STDLIB_H_ */