cppdraft_translate/cppdraft/cstdlib/syn.md

[cstdlib.syn]

17 Language support library [support]

17.2 Common definitions [support.types]

17.2.2 Header synopsis [cstdlib.syn]

🔗

namespace std {using size_t = see below; // freestandingusing div_t = see below; // freestandingusing ldiv_t = see below; // freestandingusing lldiv_t = see below; // freestanding}#define NULL see below // freestanding#define EXIT_FAILURE see below // freestanding#define EXIT_SUCCESS see below // freestanding#define RAND_MAX see below#define MB_CUR_MAX see belownamespace std {// Exposition-only function type aliasesextern "C" using c-atexit-handler = void(); // exposition onlyextern "C++" using atexit-handler = void(); // exposition onlyextern "C" using c-compare-pred = int(const void*, const void*); // exposition onlyextern "C++" using compare-pred = int(const void*, const void*); // exposition only// [support.start.term], start and terminationnoreturn void abort() noexcept; // freestandingint atexit(c-atexit-handler* func) noexcept; // freestandingint atexit(atexit-handler* func) noexcept; // freestandingint at_quick_exit(c-atexit-handler* func) noexcept; // freestandingint at_quick_exit(atexit-handler* func) noexcept; // freestandingnoreturn void exit(int status); // freestandingnoreturn void _Exit(int status) noexcept; // freestandingnoreturn void quick_exit(int status) noexcept; // freestandingchar* getenv(const char* name); int system(const char* string); // [c.malloc], C library memory allocationvoid* aligned_alloc(size_t alignment, size_t size); void* calloc(size_t nmemb, size_t size); void free(void* ptr); void free_sized(void* ptr, size_t size); void free_aligned_sized(void* ptr, size_t alignment, size_t size); void* malloc(size_t size); void* realloc(void* ptr, size_t size); size_t memalignment(const void* p); // freestandingdouble atof(const char* nptr); int atoi(const char* nptr); long int atol(const char* nptr); long long int atoll(const char* nptr); double strtod(const char* nptr, char** endptr); int strfromd(char* s, size_t n, const char* format, double fp); int strfromf(char* s, size_t n, const char* format, float fp); int strfroml(char* s, size_t n, const char* format, long double fp); float strtof(const char* nptr, char** endptr); long double strtold(const char* nptr, char** endptr); long int strtol(const char* nptr, char** endptr, int base); long long int strtoll(const char* nptr, char** endptr, int base); unsigned long int strtoul(const char* nptr, char** endptr, int base); unsigned long long int strtoull(const char* nptr, char** endptr, int base); // [c.mb.wcs], multibyte / wide string and character conversion functionsint mblen(const char* s, size_t n); int mbtowc(wchar_t* pwc, const char* s, size_t n); int wctomb(char* s, wchar_t wchar); size_t mbstowcs(wchar_t* pwcs, const char* s, size_t n); size_t wcstombs(char* s, const wchar_t* pwcs, size_t n); // [alg.c.library], C standard library algorithmsvoid* bsearch(const void* key, void* base, size_t nmemb, size_t size, // freestandingc-compare-pred** compar); void bsearch(const void* key, void* base, size_t nmemb, size_t size, // freestandingcompare-pred** compar); const void bsearch(const void* key, const void* base, size_t nmemb, // freestanding size_t size, c-compare-pred* compar); const void* bsearch(const void* key, const void* base, size_t nmemb, // freestanding size_t size, compare-pred* compar); void qsort(void* base, size_t nmemb, size_t size, c-compare-pred* compar); // freestandingvoid qsort(void* base, size_t nmemb, size_t size, compare-pred* compar); // freestanding// [c.math.rand], low-quality random number generationint rand(); void srand(unsigned int seed); // [c.math.abs], absolute valuesconstexpr int abs(int j); // freestandingconstexpr long int abs(long int j); // freestandingconstexpr long long int abs(long long int j); // freestandingconstexpr floating-point-type abs(floating-point-type j); // freestanding-deletedconstexpr long int labs(long int j); // freestandingconstexpr long long int llabs(long long int j); // freestandingconstexpr div_t div(int numer, int denom); // freestandingconstexpr ldiv_t div(long int numer, long int denom); // freestanding; see [library.c]constexpr lldiv_t div(long long int numer, long long int denom); // freestanding; see [library.c]constexpr ldiv_t ldiv(long int numer, long int denom); // freestandingconstexpr lldiv_t lldiv(long long int numer, long long int denom); // freestanding}

1

#

The contents and meaning of the header are the same as the C standard library header <stdlib.h>, except that it does not declare the types wchar_t or once_flag, and does not declare the function call_once, and except as noted in[support.types.nullptr],[support.types.layout],[support.start.term],[c.malloc],[c.mb.wcs],[alg.c.library],[c.math.rand], and[c.math.abs].

[Note 1:

Several functions have additional overloads in this document, but they have the same behavior as in the C standard library.

— end note]

See also: ISO/IEC 9899:2024, 7.24