stdlib.h

Go to the documentation of this file.

#ifndef STDLIB_H_
#define STDLIB_H_

#include <stddef.h>
#include <stdint.h>
#include <wctype.h> //TODO: remove need for this? due to wchar_t

#ifdef __cplusplus
extern "C" {
#endif //__cplusplus

#pragma mark - definitions & types -

typedef struct
{
    int quot; 
    int rem; 
} div_t;

typedef struct
{
    long quot; 
    long rem; 
} ldiv_t;

typedef struct
{
    long long quot; 
    long long rem; 
} lldiv_t;

typedef struct
{
    intmax_t quot; 
    intmax_t rem; 
} imaxdiv_t;

#define EXIT_FAILURE 1

#define EXIT_SUCCESS 0

#define RAND_MAX (0x7fffffff)

#define MB_CUR_MAX sizeof(wchar_t)

#pragma mark - runtime -

// TODO

void abort(void) __attribute__((noreturn));
int atexit(void (*)(void));
void exit(int) __attribute__((noreturn));

void _Exit(int) __attribute__((noreturn));
int at_quick_exit(void (*)(void));
void quick_exit(int) __attribute__((noreturn));
int cxa_atexit(void (*)(void*), void*, void*);

#ifndef DISABLE_UNIMPLEMENTED_LIBC_APIS
// Unsupported in bare metal environments:
char* getenv(const char*);
#endif

#ifndef DISABLE_UNIMPLEMENTED_LIBC_APIS
// Unsupported in bare metal environments:
int system(const char*);
#endif

#pragma mark - Multibyte APIs -

#ifndef DISABLE_UNIMPLEMENTED_LIBC_APIS
int mblen(const char*, size_t);
int mbtowc(wchar_t* __restrict, const char* __restrict, size_t);
int wctomb(char*, wchar_t);
size_t mbstowcs(wchar_t* __restrict, const char* __restrict, size_t);
size_t wcstombs(char* __restrict, const wchar_t* __restrict, size_t);
#endif

#pragma mark - ascii-to-x -

int atoi(const char* str);

long atol(const char* str);

long long atoll(const char* str);

double atof(const char* str);

#pragma mark - str-to-x -

float strtof(const char* __restrict str, char** __restrict str_end);

double strtod(const char* __restrict str, char** __restrict str_end);

long strtol(const char* __restrict str, char** __restrict str_end, int base);

unsigned long strtoul(const char* __restrict str, char** __restrict str_end, int base);

long long strtoll(const char* __restrict str, char** __restrict str_end, int base);

unsigned long long strtoull(const char* __restrict str, char** __restrict str_end, int base);

// TODO:
long double strtold(const char* __restrict, char** __restrict);

#pragma mark - math -

int abs(int n);

long labs(long n);

long long llabs(long long n);

intmax_t imaxabs(intmax_t j);

div_t div(int x, int y);

ldiv_t ldiv(long x, long y);

lldiv_t lldiv(long long x, long long y);

imaxdiv_t imaxdiv(intmax_t numer, intmax_t denom);

#pragma mark - random number generation -

int rand_r(unsigned int* ctx);

int rand(void);

void srand(unsigned seed);

#pragma mark - sorting -

int heapsort(void* vbase, size_t nmemb, size_t size, int (*compar)(const void*, const void*));

int heapsort_r(void* vbase, size_t nmemb, size_t size, void* thunk,
               int (*compar)(void*, const void*, const void*));

void* bsearch(const void* key, const void* ptr, size_t count, size_t size,
              int (*comp)(const void*, const void*));

void qsort_r(void* a, size_t n, size_t es, void* thunk,
             int (*cmp)(void*, const void*, const void*));

void qsort(void* a, size_t n, size_t es, int (*compar)(const void*, const void*));

#pragma mark - memory -

void* malloc(size_t size);

void free(void* ptr);

void* calloc(size_t num, size_t size);

void* realloc(void* ptr, size_t size);

void* reallocf(void* ptr, size_t size);

#ifdef _POSIX_MEMALIGN_VISIBLE

int posix_memalign(void** memptr, size_t alignment, size_t size);
#endif

#ifdef __cplusplus
}
#endif //__cplusplus

#endif // STDLIB_H_