blob: 6888e8c20efc97ca6b499c073b8f7f3c2efe751c [file] [log] [blame]
The Android Open Source Project1dc9e472009-03-03 19:28:35 -08001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * * Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in
12 * the documentation and/or other materials provided with the
13 * distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
Elliott Hughes76f89162015-01-26 13:34:58 -080028
29#ifndef _STDLIB_H
30#define _STDLIB_H
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080031
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080032#include <alloca.h>
Elliott Hughes21b56eb2017-10-20 17:57:17 -070033#include <bits/wait.h>
Elliott Hughes76f89162015-01-26 13:34:58 -080034#include <malloc.h>
35#include <stddef.h>
Elliott Hughes21b56eb2017-10-20 17:57:17 -070036#include <sys/cdefs.h>
37#include <xlocale.h>
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080038
39__BEGIN_DECLS
40
41#define EXIT_FAILURE 1
42#define EXIT_SUCCESS 0
43
Elliott Hughes3b2096a2016-07-22 18:57:12 -070044__noreturn void abort(void);
Elliott Hughesfaa74342017-08-11 17:34:44 -070045__noreturn void exit(int __status);
Elliott Hughes2f94a292017-09-18 14:40:01 -070046#if __ANDROID_API__ >= __ANDROID_API_L__
Elliott Hughesfaa74342017-08-11 17:34:44 -070047__noreturn void _Exit(int __status) __INTRODUCED_IN(21);
Elliott Hughes2f94a292017-09-18 14:40:01 -070048#else
49__noreturn void _Exit(int) __RENAME(_exit);
50#endif
51
Elliott Hughesfaa74342017-08-11 17:34:44 -070052int atexit(void (*__fn)(void));
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080053
Elliott Hughesfaa74342017-08-11 17:34:44 -070054int at_quick_exit(void (*__fn)(void)) __INTRODUCED_IN(21);
55void quick_exit(int __status) __noreturn __INTRODUCED_IN(21);
Dan Albertb8425c52014-04-29 17:49:06 -070056
Elliott Hughesfaa74342017-08-11 17:34:44 -070057char* getenv(const char* __name);
58int putenv(char* __assignment);
59int setenv(const char* __name, const char* __value, int __overwrite);
60int unsetenv(const char* __name);
Elliott Hughes3b2096a2016-07-22 18:57:12 -070061int clearenv(void);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080062
Elliott Hughesfaa74342017-08-11 17:34:44 -070063char* mkdtemp(char* __template);
64char* mktemp(char* __template) __attribute__((deprecated("mktemp is unsafe, use mkstemp or tmpfile instead")));
Elliott Hughes31165ed2014-09-23 17:34:29 -070065
Elliott Hughesfaa74342017-08-11 17:34:44 -070066int mkostemp64(char* __template, int __flags) __INTRODUCED_IN(23);
67int mkostemp(char* __template, int __flags) __INTRODUCED_IN(23);
68int mkostemps64(char* __template, int __suffix_length, int __flags) __INTRODUCED_IN(23);
69int mkostemps(char* __template, int __suffix_length, int __flags) __INTRODUCED_IN(23);
70int mkstemp64(char* __template) __INTRODUCED_IN(21);
71int mkstemp(char* __template);
72int mkstemps64(char* __template, int __flags) __INTRODUCED_IN(23);
73int mkstemps(char* __template, int __flags);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080074
Elliott Hughesfaa74342017-08-11 17:34:44 -070075long strtol(const char* __s, char** __end_ptr, int __base);
76long long strtoll(const char* __s, char** __end_ptr, int __base);
77unsigned long strtoul(const char* __s, char** __end_ptr, int __base);
78unsigned long long strtoull(const char* __s, char** __end_ptr, int __base);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080079
Dan Alberte219cef2018-03-29 15:12:05 -070080int posix_memalign(void** __memptr, size_t __alignment, size_t __size) __INTRODUCED_IN(17);
Ken Sumrall85aad902011-12-14 20:50:01 -080081
Christopher Ferriscae21a92018-02-05 18:14:55 -080082void* aligned_alloc(size_t __alignment, size_t __size) __INTRODUCED_IN(28);
83
Elliott Hughesfaa74342017-08-11 17:34:44 -070084double strtod(const char* __s, char** __end_ptr);
Elliott Hughes50cda382017-09-14 15:30:08 -070085long double strtold(const char* __s, char** __end_ptr) __RENAME_LDBL(strtod, 3, 21);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080086
Elliott Hughesfaa74342017-08-11 17:34:44 -070087unsigned long strtoul_l(const char* __s, char** __end_ptr, int __base, locale_t __l) __INTRODUCED_IN(26);
Dan Albertdfb5ce42014-07-09 22:51:34 +000088
Elliott Hughesfaa74342017-08-11 17:34:44 -070089int atoi(const char* __s) __attribute_pure__;
90long atol(const char* __s) __attribute_pure__;
91long long atoll(const char* __s) __attribute_pure__;
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080092
Elliott Hughesfaa74342017-08-11 17:34:44 -070093char* realpath(const char* __path, char* __resolved);
94int system(const char* __command);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080095
Elliott Hughesfaa74342017-08-11 17:34:44 -070096void* bsearch(const void* __key, const void* __base, size_t __nmemb, size_t __size, int (*__comparator)(const void* __lhs, const void* __rhs));
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080097
Elliott Hughesfaa74342017-08-11 17:34:44 -070098void qsort(void* __base, size_t __nmemb, size_t __size, int (*__comparator)(const void* __lhs, const void* __rhs));
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080099
Yabin Cuia39f9392014-10-28 12:04:02 -0700100uint32_t arc4random(void);
Elliott Hughesfaa74342017-08-11 17:34:44 -0700101uint32_t arc4random_uniform(uint32_t __upper_bound);
102void arc4random_buf(void* __buf, size_t __n);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800103
104#define RAND_MAX 0x7fffffff
Elliott Hughesa0beeea2014-06-12 11:48:04 -0700105
Elliott Hughesfaa74342017-08-11 17:34:44 -0700106int rand_r(unsigned int* __seed_ptr) __INTRODUCED_IN(21);
Elliott Hughesa0beeea2014-06-12 11:48:04 -0700107
Elliott Hughes274afe82014-11-06 12:40:08 -0800108double drand48(void);
Elliott Hughesfaa74342017-08-11 17:34:44 -0700109double erand48(unsigned short __xsubi[3]);
110long jrand48(unsigned short __xsubi[3]);
111void lcong48(unsigned short __param[7]) __INTRODUCED_IN(23);
Elliott Hughes274afe82014-11-06 12:40:08 -0800112long lrand48(void);
113long mrand48(void);
Elliott Hughesfaa74342017-08-11 17:34:44 -0700114long nrand48(unsigned short __xsubi[3]);
115unsigned short* seed48(unsigned short __seed16v[3]);
116void srand48(long __seed);
Elliott Hughes274afe82014-11-06 12:40:08 -0800117
Elliott Hughesfaa74342017-08-11 17:34:44 -0700118char* initstate(unsigned int __seed, char* __state, size_t __n) __INTRODUCED_IN(21);
119char* setstate(char* __state) __INTRODUCED_IN(21);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800120
Elliott Hughes49167062014-07-25 17:24:00 -0700121int getpt(void);
Elliott Hughesfaa74342017-08-11 17:34:44 -0700122int posix_openpt(int __flags) __INTRODUCED_IN(21);
123char* ptsname(int __fd);
124int ptsname_r(int __fd, char* __buf, size_t __n);
125int unlockpt(int __fd);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800126
Elliott Hughesfaa74342017-08-11 17:34:44 -0700127int getsubopt(char** __option, char* const* __tokens, char** __value_ptr) __INTRODUCED_IN(26);
Elliott Hughesdf143f82016-04-04 17:34:04 -0700128
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800129typedef struct {
Elliott Hughesfaa74342017-08-11 17:34:44 -0700130 int quot;
131 int rem;
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800132} div_t;
133
Elliott Hughesfaa74342017-08-11 17:34:44 -0700134div_t div(int __numerator, int __denominator) __attribute_const__;
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800135
136typedef struct {
Elliott Hughesfaa74342017-08-11 17:34:44 -0700137 long int quot;
138 long int rem;
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800139} ldiv_t;
140
Elliott Hughesfaa74342017-08-11 17:34:44 -0700141ldiv_t ldiv(long __numerator, long __denominator) __attribute_const__;
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800142
143typedef struct {
Elliott Hughesfaa74342017-08-11 17:34:44 -0700144 long long int quot;
145 long long int rem;
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800146} lldiv_t;
147
Elliott Hughesfaa74342017-08-11 17:34:44 -0700148lldiv_t lldiv(long long __numerator, long long __denominator) __attribute_const__;
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800149
Elliott Hughes692207e2014-02-28 16:23:27 -0800150/* BSD compatibility. */
Elliott Hughes3b2096a2016-07-22 18:57:12 -0700151const char* getprogname(void) __INTRODUCED_IN(21);
Elliott Hughesfaa74342017-08-11 17:34:44 -0700152void setprogname(const char* __name) __INTRODUCED_IN(21);
Elliott Hughes692207e2014-02-28 16:23:27 -0800153
Elliott Hughesfaa74342017-08-11 17:34:44 -0700154int mblen(const char* __s, size_t __n) __INTRODUCED_IN(26) __VERSIONER_NO_GUARD;
155size_t mbstowcs(wchar_t* __dst, const char* __src, size_t __n);
156int mbtowc(wchar_t* __wc_ptr, const char* __s, size_t __n) __INTRODUCED_IN(21) __VERSIONER_NO_GUARD;
157int wctomb(char* __dst, wchar_t __wc) __INTRODUCED_IN(21) __VERSIONER_NO_GUARD;
Dan Albertcb0b1432016-09-06 16:51:00 -0700158
Elliott Hughesfaa74342017-08-11 17:34:44 -0700159size_t wcstombs(char* __dst, const wchar_t* __src, size_t __n);
David 'Digit' Turnerbb5581a2010-10-09 17:56:55 +0200160
Elliott Hughes5bc78c82016-11-16 11:35:43 -0800161#if __ANDROID_API__ >= __ANDROID_API_L__
Elliott Hughes3b2096a2016-07-22 18:57:12 -0700162size_t __ctype_get_mb_cur_max(void) __INTRODUCED_IN(21);
Dan Albert224ff042014-08-14 13:56:51 -0700163#define MB_CUR_MAX __ctype_get_mb_cur_max()
Dan Albertcb0b1432016-09-06 16:51:00 -0700164#else
165/*
Dan Albert5c15b8c2017-02-21 15:54:58 -0800166 * Pre-L we didn't have any locale support and so we were always the POSIX
167 * locale. POSIX specifies that MB_CUR_MAX for the POSIX locale is 1:
168 * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/stdlib.h.html
Dan Albertcb0b1432016-09-06 16:51:00 -0700169 */
Dan Albert5c15b8c2017-02-21 15:54:58 -0800170#define MB_CUR_MAX 1
Dan Albertcb0b1432016-09-06 16:51:00 -0700171#endif
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800172
George Burgess IVb97049c2017-07-24 15:05:05 -0700173#if defined(__BIONIC_INCLUDE_FORTIFY_HEADERS)
174#include <bits/fortify/stdlib.h>
175#endif
Daniel Micay3244d9f2015-04-18 13:04:19 -0400176
Ryan Prichard51a7fe82018-01-08 16:18:48 -0800177#if __ANDROID_API__ >= __ANDROID_API_K__
178int abs(int __x) __attribute_const__ __INTRODUCED_IN(19);
179long labs(long __x) __attribute_const__ __INTRODUCED_IN(19);
180long long llabs(long long __x) __attribute_const__ __INTRODUCED_IN(19);
181#else
182// Implemented as static inlines before 19.
183#endif
184
Elliott Hughes5bc78c82016-11-16 11:35:43 -0800185#if __ANDROID_API__ >= __ANDROID_API_L__
Elliott Hughesfaa74342017-08-11 17:34:44 -0700186float strtof(const char* __s, char** __end_ptr) __INTRODUCED_IN(21);
187double atof(const char* __s) __attribute_pure__ __INTRODUCED_IN(21);
Josh Gaob6a4a4c2016-07-26 16:34:40 -0700188int rand(void) __INTRODUCED_IN(21);
Elliott Hughesfaa74342017-08-11 17:34:44 -0700189void srand(unsigned int __seed) __INTRODUCED_IN(21);
Josh Gaob6a4a4c2016-07-26 16:34:40 -0700190long random(void) __INTRODUCED_IN(21);
Elliott Hughesfaa74342017-08-11 17:34:44 -0700191void srandom(unsigned int __seed) __INTRODUCED_IN(21);
192int grantpt(int __fd) __INTRODUCED_IN(21);
Josh Gao6cd9fb02016-09-23 14:06:05 -0700193
Elliott Hughesfaa74342017-08-11 17:34:44 -0700194long long strtoll_l(const char* __s, char** __end_ptr, int __base, locale_t __l) __INTRODUCED_IN(21);
195unsigned long long strtoull_l(const char* __s, char** __end_ptr, int __base, locale_t __l) __INTRODUCED_IN(21);
196long double strtold_l(const char* __s, char** __end_ptr, locale_t __l) __INTRODUCED_IN(21);
Josh Gao8778d642016-07-22 15:26:36 -0700197#else
198// Implemented as static inlines before 21.
199#endif
200
Elliott Hughes4cae5c32017-07-10 11:51:00 -0700201#if __ANDROID_API__ >= __ANDROID_API_O__
Elliott Hughesfaa74342017-08-11 17:34:44 -0700202double strtod_l(const char* __s, char** __end_ptr, locale_t __l) __INTRODUCED_IN(26);
203float strtof_l(const char* __s, char** __end_ptr, locale_t __l) __INTRODUCED_IN(26);
204long strtol_l(const char* __s, char** __end_ptr, int, locale_t __l) __INTRODUCED_IN(26);
Josh Gao6cd9fb02016-09-23 14:06:05 -0700205#else
Elliott Hughes4cae5c32017-07-10 11:51:00 -0700206// Implemented as static inlines before 26.
Josh Gao6cd9fb02016-09-23 14:06:05 -0700207#endif
208
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800209__END_DECLS
210
Josh Gaob8e1b7052016-04-13 17:18:20 -0700211#include <android/legacy_stdlib_inlines.h>
212
Elliott Hughes76f89162015-01-26 13:34:58 -0800213#endif /* _STDLIB_H */