Module `libc/stdlib`

libc/stdlib

Stability: unstable — a raw C binding, not a Yo design. Callers in `std/` take narrow slices of it: `getenv` / `setenv` / `unsetenv` / `realpath` for `std/env`, `exit` for `std/process`, `atof` for `std/encoding/json`'s number parser. Those modules are the supported surface. `malloc` / `free` / `realloc` are bound but are NOT how Yo allocates — that is `std/allocator` and the runtime's own allocator — and calling them on a Yo-owned pointer is a heap bug. Freezing follows the modules above it; the binding set itself is additive-by-demand. — stable modules only change additively; this one may still change.

C11 <stdlib.h> — general utility functions.

Stability

unstable — a raw C binding, not a Yo design. Callers in std/ take narrow slices of it: getenv / setenv / unsetenv / realpath for std/env, exit for std/process, atof for std/encoding/json's number parser. Those modules are the supported surface. malloc / free / realloc are bound but are NOT how Yo allocates — that is std/allocator and the runtime's own allocator — and calling them on a Yo-owned pointer is a heap bug. Freezing follows the modules above it; the binding set itself is additive-by-demand.

Types

div_t type-alias

div_t

ldiv_t type-alias

ldiv_t

lldiv_t type-alias

lldiv_t

wchar_t type-alias

wchar_t

Functions

exit function

fn(status : int) -> unit

Parameters

Name	Type	Notes
`status`	int

Returns: unit

quick_exit function

fn(status : int) -> unit

Parameters

Name	Type	Notes
`status`	int

Returns: unit

_Exit function

fn(status : int) -> unit

Parameters

Name	Type	Notes
`status`	int

Returns: unit

abort function

fn() -> unit

Returns: unit

atexit function

fn(func : fn() -> unit) -> int

Parameters

Name	Type	Notes
`func`	fn() -> unit

Returns: int

at_quick_exit function

fn(func : fn() -> unit) -> int

Parameters

Name	Type	Notes
`func`	fn() -> unit

Returns: int

malloc function

fn(size : usize) -> ?(*(void))

Parameters

Name	Type	Notes
`size`	usize

Returns: ?(*(void))

calloc function

fn(nmemb : usize, size : usize) -> ?(*(void))

Parameters

Name	Type	Notes
`nmemb`	usize
`size`	usize

Returns: ?(*(void))

realloc function

fn(ptr : ?(*(void)), size : usize) -> ?(*(void))

Parameters

Name	Type	Notes
`ptr`	?(*(void))
`size`	usize

Returns: ?(*(void))

free function

fn(ptr : ?(*(void))) -> unit

Parameters

Name	Type	Notes
`ptr`	?(*(void))

Returns: unit

aligned_alloc function

fn(alignment : usize, size : usize) -> ?(*(void))

C11 aligned_alloc, released with free. Raw and non-portable: it is absent from the Windows CRT (which offers _aligned_malloc / _aligned_free instead), so a call to it does not compile for the *-pc-windows-* targets, and C11 leaves the result undefined unless alignment is a supported power of two and size is a multiple of it (macOS enforces both by returning NULL; glibc enforces neither). GlobalAllocator.aligned_alloc / aligned_free in std/allocator is the portable pair.

Parameters

Name	Type	Notes
`alignment`	usize
`size`	usize

Returns: ?(*(void))

atof function

fn(nptr : *(char)) -> f64

Parameters

Name	Type	Notes
`nptr`	*(char)

Returns: f64

atoi function

fn(nptr : *(char)) -> int

Parameters

Name	Type	Notes
`nptr`	*(char)

Returns: int

atol function

fn(nptr : *(char)) -> long

Parameters

Name	Type	Notes
`nptr`	*(char)

Returns: long

atoll function

fn(nptr : *(char)) -> longlong

Parameters

Name	Type	Notes
`nptr`	*(char)

Returns: longlong

strtol function

fn(nptr : *(char), endptr : ?(*(?(*(char)))), base : int) -> long

Parameters

Name	Type	Notes
`nptr`	*(char)
`endptr`	?((?((char))))
`base`	int

Returns: long

strtoll function

fn(nptr : *(char), endptr : ?(*(?(*(char)))), base : int) -> longlong

Parameters

Name	Type	Notes
`nptr`	*(char)
`endptr`	?((?((char))))
`base`	int

Returns: longlong

strtoul function

fn(nptr : *(char), endptr : ?(*(?(*(char)))), base : int) -> ulong

Parameters

Name	Type	Notes
`nptr`	*(char)
`endptr`	?((?((char))))
`base`	int

Returns: ulong

strtoull function

fn(nptr : *(char), endptr : ?(*(?(*(char)))), base : int) -> ulonglong

Parameters

Name	Type	Notes
`nptr`	*(char)
`endptr`	?((?((char))))
`base`	int

Returns: ulonglong

strtof function

fn(nptr : *(char), endptr : ?(*(?(*(char))))) -> f32

Parameters

Name	Type	Notes
`nptr`	*(char)
`endptr`	?((?((char))))

Returns: f32

strtod function

fn(nptr : *(char), endptr : ?(*(?(*(char))))) -> f64

Parameters

Name	Type	Notes
`nptr`	*(char)
`endptr`	?((?((char))))

Returns: f64

strtold function

fn(nptr : *(char), endptr : ?(*(?(*(char))))) -> longdouble

Parameters

Name	Type	Notes
`nptr`	*(char)
`endptr`	?((?((char))))

Returns: longdouble

rand function

fn() -> int

Returns: int

srand function

fn(seed : uint) -> unit

Parameters

Name	Type	Notes
`seed`	uint

Returns: unit

rand_r function

fn(seedp : *(uint)) -> int

Parameters

Name	Type	Notes
`seedp`	*(uint)

Returns: int

bsearch function

fn(key : *(void), base : *(void), nmemb : usize, size : usize, compar : fn(a : *(void), b : *(void)) -> int) -> ?(*(void))

Parameters

Name	Type	Notes
`key`	*(void)
`base`	*(void)
`nmemb`	usize
`size`	usize
`compar`	fn(a : (void), b : (void)) -> int

Returns: ?(*(void))

qsort function

fn(base : *(void), nmemb : usize, size : usize, compar : fn(a : *(void), b : *(void)) -> int) -> unit

Parameters

Name	Type	Notes
`base`	*(void)
`nmemb`	usize
`size`	usize
`compar`	fn(a : (void), b : (void)) -> int

Returns: unit

abs function

fn(j : int) -> int

Parameters

Name	Type	Notes
`j`	int

Returns: int

labs function

fn(j : long) -> long

Parameters

Name	Type	Notes
`j`	long

Returns: long

llabs function

fn(j : longlong) -> longlong

Parameters

Name	Type	Notes
`j`	longlong

Returns: longlong

div function

fn(numer : int, denom : int) -> div_t

Parameters

Name	Type	Notes
`numer`	int
`denom`	int

Returns: div_t

ldiv function

fn(numer : long, denom : long) -> ldiv_t

Parameters

Name	Type	Notes
`numer`	long
`denom`	long

Returns: ldiv_t

lldiv function

fn(numer : longlong, denom : longlong) -> lldiv_t

Parameters

Name	Type	Notes
`numer`	longlong
`denom`	longlong

Returns: lldiv_t

getenv function

fn(name : *(char)) -> ?(*(char))

Parameters

Name	Type	Notes
`name`	*(char)

Returns: ?(*(char))

setenv function

fn(name : *(char), value : *(char), overwrite : int) -> int

Parameters

Name	Type	Notes
`name`	*(char)
`value`	*(char)
`overwrite`	int

Returns: int

unsetenv function

fn(name : *(char)) -> int

Parameters

Name	Type	Notes
`name`	*(char)

Returns: int

realpath function

fn(path : *(char), resolved_path : ?(*(char))) -> ?(*(char))

Parameters

Name	Type	Notes
`path`	*(char)
`resolved_path`	?(*(char))

Returns: ?(*(char))

system function

fn(command : ?(*(char))) -> int

Parameters

Name	Type	Notes
`command`	?(*(char))

Returns: int

getenv_s function

fn(len : ?(*(usize)), value : *(char), maxsize : usize, name : *(char)) -> int

Parameters

Name	Type	Notes
`len`	?(*(usize))
`value`	*(char)
`maxsize`	usize
`name`	*(char)

Returns: int

mblen function

fn(s : ?(*(char)), n : usize) -> int

Parameters

Name	Type	Notes
`s`	?(*(char))
`n`	usize

Returns: int

mbtowc function

fn(pwc : ?(*(wchar_t)), s : ?(*(char)), n : usize) -> int

Parameters

Name	Type	Notes
`pwc`	?(*(wchar_t))
`s`	?(*(char))
`n`	usize

Returns: int

wctomb function

fn(s : ?(*(char)), wc : wchar_t) -> int

Parameters

Name	Type	Notes
`s`	?(*(char))
`wc`	wchar_t

Returns: int

mbstowcs function

fn(dest : ?(*(wchar_t)), src : *(char), n : usize) -> usize

Parameters

Name	Type	Notes
`dest`	?(*(wchar_t))
`src`	*(char)
`n`	usize

Returns: usize

wcstombs function

fn(dest : ?(*(char)), src : *(wchar_t), n : usize) -> usize

Parameters

Name	Type	Notes
`dest`	?(*(char))
`src`	*(wchar_t)
`n`	usize

Returns: usize

mbstowcs_s function

fn(retval : ?(*(usize)), dest : ?(*(wchar_t)), destsz : usize, src : *(char), len : usize) -> int

Parameters

Name	Type	Notes
`retval`	?(*(usize))
`dest`	?(*(wchar_t))
`destsz`	usize
`src`	*(char)
`len`	usize

Returns: int

wcstombs_s function

fn(retval : ?(*(usize)), dest : ?(*(char)), destsz : usize, src : *(wchar_t), len : usize) -> int

Parameters

Name	Type	Notes
`retval`	?(*(usize))
`dest`	?(*(char))
`destsz`	usize
`src`	*(wchar_t)
`len`	usize

Returns: int

Constants

EXIT_SUCCESS constant int

Value: <unknown: int>

EXIT_FAILURE constant int

Value: <unknown: int>

RAND_MAX constant int

Value: <unknown: int>

MB_CUR_MAX constant int

Value: <unknown: int>

Module libc/stdlib

Stability

Types

Functions

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Constants

Module `libc/stdlib`