/**************************************************************************** * include/stdlib.h * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. The * ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the * License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * ****************************************************************************/ #ifndef __INCLUDE_STDLIB_H #define __INCLUDE_STDLIB_H /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ /* The C standard specifies two constants, EXIT_SUCCESS and EXIT_FAILURE, * that may be passed to exit() to indicate successful or unsuccessful * termination, respectively. */ #define EXIT_SUCCESS 0 #define EXIT_FAILURE 1 /* The NULL pointer should be defined in this file but is currently defined * in sys/types.h. */ /* Maximum value returned by rand(). Must be a minimum of 32767. */ #define RAND_MAX INT_MAX /* Integer expression whose value is the maximum number of bytes in a * character specified by the current locale. */ #define MB_CUR_MAX 1 /* The environ variable, normally 'char **environ;' is not implemented as a * function call. However, get_environ_ptr() can be used in its place. */ #ifndef CONFIG_DISABLE_ENVIRON # define environ get_environ_ptr() #endif /**************************************************************************** * Public Type Definitions ****************************************************************************/ struct mallinfo { int arena; /* This is the total size of memory allocated * for use by malloc in bytes. */ int ordblks; /* This is the number of free (not in use) chunks */ int mxordblk; /* Size of the largest free (not in use) chunk */ int uordblks; /* This is the total size of memory occupied by * chunks handed out by malloc. */ int fordblks; /* This is the total size of memory occupied * by free (not in use) chunks. */ }; /* Structure type returned by the div() function. */ struct div_s { int quot; /* Quotient */ int rem; /* Remainder */ }; typedef struct div_s div_t; /* Structure type returned by the ldiv() function. */ struct ldiv_s { long quot; /* Quotient */ long rem; /* Remainder */ }; typedef struct ldiv_s ldiv_t; /* Structure type returned by the lldiv() function. */ struct lldiv_s { long quot; /* Quotient */ long rem; /* Remainder */ }; typedef struct lldiv_s lldiv_t; /**************************************************************************** * Public Function Prototypes ****************************************************************************/ #undef EXTERN #if defined(__cplusplus) #define EXTERN extern "C" extern "C" { #else #define EXTERN extern #endif /* Random number generation */ void srand(unsigned int seed); int rand(void); #define srandom(s) srand(s) long random(void); #ifndef CONFIG_DISABLE_ENVIRON /* Environment variable support */ FAR char **get_environ_ptr(void); FAR char *getenv(FAR const char *name); int putenv(FAR const char *string); int clearenv(void); int setenv(FAR const char *name, FAR const char *value, int overwrite); int unsetenv(FAR const char *name); #endif /* Process exit functions */ void exit(int status) noreturn_function; void abort(void) noreturn_function; #ifdef CONFIG_SCHED_ATEXIT int atexit(CODE void (*func)(void)); #endif #ifdef CONFIG_SCHED_ONEXIT int on_exit(CODE void (*func)(int, FAR void *), FAR void *arg); #endif /* _Exit() is a stdlib.h equivalent to the unistd.h _exit() function */ void _exit(int status); /* See unistd.h */ #ifdef CONFIG_HAVE_INLINE static inline void _Exit(int s) { _exit(s); } #else #define _Exit(s) _exit(s) #endif /* System() command is not implemented in the NuttX libc because it is so * entangled with shell logic. There is an experimental version at * apps/system/system. system() is prototyped here, however, for * standards compatibility. */ #ifndef __KERNEL__ int system(FAR const char *cmd); #endif /* String to binary conversions */ long strtol(FAR const char *nptr, FAR char **endptr, int base); unsigned long strtoul(FAR const char *nptr, FAR char **endptr, int base); #ifdef CONFIG_HAVE_LONG_LONG long long strtoll(FAR const char *nptr, FAR char **endptr, int base); unsigned long long strtoull(FAR const char *nptr, FAR char **endptr, int base); #endif float strtof(FAR const char *str, FAR char **endptr); #ifdef CONFIG_HAVE_DOUBLE double strtod(FAR const char *str, FAR char **endptr); #endif #ifdef CONFIG_HAVE_LONG_DOUBLE long double strtold(FAR const char *str, FAR char **endptr); #endif #ifdef CONFIG_HAVE_INLINE static inline int atoi(FAR const char *nptr) { return (int)strtol(nptr, NULL, 10); } #else #define atoi(nptr) ((int)strtol((nptr), NULL, 10)) #endif #ifdef CONFIG_HAVE_INLINE static inline int atol(FAR const char *nptr) { return strtol(nptr, NULL, 10); } #else #define atol(nptr) strtol((nptr), NULL, 10) #endif #ifdef CONFIG_HAVE_LONG_LONG #ifdef CONFIG_HAVE_INLINE static inline long long atoll(FAR const char *nptr) { return strtoll(nptr, NULL, 10); } #else #define atoll(nptr) strtoll((nptr), NULL, 10) #endif #endif #ifdef CONFIG_HAVE_DOUBLE #ifdef CONFIG_HAVE_INLINE static inline double atof(FAR const char *nptr) { return strtod(nptr, NULL); } #else #define atof(nptr) strtod((nptr), NULL) #endif #endif /* Binary to string conversions */ FAR char *itoa(int val, FAR char *str, int base); /* Wide character operations */ #ifdef CONFIG_LIBC_WCHAR int mblen(FAR const char *s, size_t n); int mbtowc(FAR wchar_t *pwc, FAR const char *s, size_t n); size_t mbstowcs(FAR wchar_t *dst, FAR const char *src, size_t len); int wctomb(FAR char *s, wchar_t wchar); size_t wcstombs(FAR char *dst, FAR const wchar_t *src, size_t len); #endif /* Memory Management */ FAR void *malloc(size_t); void free(FAR void *); FAR void *realloc(FAR void *, size_t); FAR void *memalign(size_t, size_t); FAR void *zalloc(size_t); FAR void *calloc(size_t, size_t); #ifdef CONFIG_HAVE_INLINE static inline FAR void *aligned_alloc(size_t a, size_t s) { return memalign(a, s); } static inline int posix_memalign(FAR void **m, size_t a, size_t s) { return (*m = memalign(a, s)) ? OK : ENOMEM; } #else #define aligned_alloc(a, s) memalign((a), (s)) #define posix_memalign(m, a, s) ((*(m) = memalign((a), (s))) ? OK : ENOMEM) #endif struct mallinfo mallinfo(void); /* Pseudo-Terminals */ #ifdef CONFIG_PSEUDOTERM_SUSV1 FAR char *ptsname(int fd); int ptsname_r(int fd, FAR char *buf, size_t buflen); #endif #ifdef CONFIG_PSEUDOTERM int unlockpt(int fd); /* int grantpt(int fd); Not implemented */ #define grantpt(fd) (0) #endif /* Arithmetic */ int abs(int j); long int labs(long int j); #ifdef CONFIG_HAVE_LONG_LONG long long int llabs(long long int j); #endif div_t div(int number, int denom); ldiv_t ldiv(long number, long denom); #ifdef CONFIG_HAVE_LONG_LONG lldiv_t lldiv(long long number, long long denom); #endif /* Temporary files */ int mktemp(FAR char *path_template); int mkstemp(FAR char *path_template); /* Sorting */ void qsort(FAR void *base, size_t nel, size_t width, CODE int (*compar)(FAR const void *, FAR const void *)); /* Binary search */ FAR void *bsearch(FAR const void *key, FAR const void *base, size_t nel, size_t width, CODE int (*compar)(FAR const void *, FAR const void *)); #undef EXTERN #if defined(__cplusplus) } #endif #endif /* __INCLUDE_STDLIB_H */