vasilito/RedBear-OS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add descriptions to inttypes header and related functions

Browse Source
This commit is contained in:
auronandace
2026-06-15 15:09:18 +01:00
parent 527a268a7a
commit 68758f3f90
3 changed files with 136 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/header/inttypes/mod.rs
+56 -21
View File
@@ -15,31 +15,48 @@ use crate::{
};
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/imaxabs.html>.
///
/// Computes the absolute value of the integer `j`.
#[unsafe(no_mangle)]
pub extern "C" fn imaxabs(i: intmax_t) -> intmax_t {
i.abs()
pub extern "C" fn imaxabs(j: intmax_t) -> intmax_t {
j.abs()
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/inttypes.h.html>.
///
/// Structure type that is the type of the value returned by the `imaxdiv()`
/// function.
#[repr(C)]
pub struct imaxdiv_t {
/// The quotient.
quot: intmax_t,
/// The remainder.
rem: intmax_t,
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/imaxdiv.html>.
///
/// Computes `numer` / `denom` and `numer` % `denom` in a single operation.
///
/// Returns the struct `imaxdiv_t`, comprising both the quotient and remainder.
#[unsafe(no_mangle)]
pub extern "C" fn imaxdiv(i: intmax_t, j: intmax_t) -> imaxdiv_t {
pub extern "C" fn imaxdiv(numer: intmax_t, denom: intmax_t) -> imaxdiv_t {
imaxdiv_t {
quot: i / j,
rem: i % j,
quot: numer / denom,
rem: numer % denom,
}
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/strtoimax.html>.
///
/// Equivalent to `strtol()` and `strtoll()`, except that the initial portion
/// of the string shall be converted to `intmax_t`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed or the value of `base` is not supported, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn strtoimax(
s: *const c_char,
nptr: *const c_char,
endptr: *mut *mut c_char,
base: c_int,
) -> intmax_t {
@@ -48,16 +65,22 @@ pub unsafe extern "C" fn strtoimax(
false,
intmax_t::MAX,
intmax_t::MIN,
s,
nptr,
endptr,
base
)
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/strtoimax.html>.
///
/// Equivalent to `strtoul()` and `strtoull()`, except that the initial portion
/// of the string shall be converted to `uintmax_t`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed or the value of `base` is not supported, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn strtoumax(
s: *const c_char,
nptr: *const c_char,
endptr: *mut *mut c_char,
base: c_int,
) -> uintmax_t {
@@ -66,39 +89,51 @@ pub unsafe extern "C" fn strtoumax(
false,
uintmax_t::MAX,
uintmax_t::MIN,
s,
nptr,
endptr,
base
)
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/wcstoimax.html>.
///
/// Equivalent to `wctol()` and `wctoll()`, except that the initial portion
/// of the wide string shall be converted to `intmax_t`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed, returns `0`.
#[expect(clippy::cast_lossless)] // not all users of `wcsto_impl!` are lossless
#[unsafe(no_mangle)]
pub unsafe extern "C" fn wcstoimax(
mut ptr: *const wchar_t,
end: *mut *mut wchar_t,
mut nptr: *const wchar_t,
endptr: *mut *mut wchar_t,
base: c_int,
) -> intmax_t {
skipws!(ptr);
let result = wcsto_impl!(intmax_t, ptr, base);
if !end.is_null() {
unsafe { *end = ptr.cast_mut() };
skipws!(nptr);
let result = wcsto_impl!(intmax_t, nptr, base);
if !endptr.is_null() {
unsafe { *endptr = nptr.cast_mut() };
}
result
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/wcstoimax.html>.
///
/// Equivalent to `wctoul()` and `wctoull()`, except that the initial portion
/// of the wide string shall be converted to `uintmax_t`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn wcstoumax(
mut ptr: *const wchar_t,
end: *mut *mut wchar_t,
mut nptr: *const wchar_t,
endptr: *mut *mut wchar_t,
base: c_int,
) -> uintmax_t {
skipws!(ptr);
let result = wcsto_impl!(uintmax_t, ptr, base);
if !end.is_null() {
unsafe { *end = ptr.cast_mut() };
skipws!(nptr);
let result = wcsto_impl!(uintmax_t, nptr, base);
if !endptr.is_null() {
unsafe { *endptr = nptr.cast_mut() };
}
result
}
src/header/stdlib/mod.rs
+32 -8
View File
@@ -1488,17 +1488,29 @@ pub unsafe extern "C" fn strtof(s: *const c_char, endptr: *mut *mut c_char) -> c
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/strtol.html>.
///
/// Converts the initial portion of the string pointed to by `nptr` to a type
/// `long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed or the value of `base` is not supported, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn strtol(s: *const c_char, endptr: *mut *mut c_char, base: c_int) -> c_long {
strto_impl!(c_long, true, c_long::MAX, c_long::MIN, s, endptr, base)
pub unsafe extern "C" fn strtol(nptr: *const c_char, endptr: *mut *mut c_char, base: c_int) -> c_long {
strto_impl!(c_long, true, c_long::MAX, c_long::MIN, nptr, endptr, base)
}
// TODO: strtold(), when long double is available
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/strtol.html>.
///
/// Converts the initial portion of the string pointed to by `nptr` to a type
/// `long long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed or the value of `base` is not supported, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn strtoll(
s: *const c_char,
nptr: *const c_char,
endptr: *mut *mut c_char,
base: c_int,
) -> c_longlong {
@@ -1507,26 +1519,38 @@ pub unsafe extern "C" fn strtoll(
true,
c_longlong::MAX,
c_longlong::MIN,
s,
nptr,
endptr,
base
)
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/strtoul.html>.
///
/// Converts the initial portion of the string pointed to by `str` to a type
/// `unsigned long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed or the value of `base` is not supported, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn strtoul(
s: *const c_char,
str: *const c_char,
endptr: *mut *mut c_char,
base: c_int,
) -> c_ulong {
strto_impl!(c_ulong, false, c_ulong::MAX, c_ulong::MIN, s, endptr, base)
strto_impl!(c_ulong, false, c_ulong::MAX, c_ulong::MIN, str, endptr, base)
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/strtoul.html>.
///
/// Converts the initial portion of the string pointed to by `str` to a type
/// `unsigned long long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed or the value of `base` is not supported, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn strtoull(
s: *const c_char,
str: *const c_char,
endptr: *mut *mut c_char,
base: c_int,
) -> c_ulonglong {
@@ -1535,7 +1559,7 @@ pub unsafe extern "C" fn strtoull(
false,
c_ulonglong::MAX,
c_ulonglong::MIN,
s,
str,
endptr,
base
)
src/header/wchar/mod.rs
+48 -24
View File
@@ -848,62 +848,86 @@ pub unsafe extern "C" fn wcstok(
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/wcstol.html>.
///
/// Converts the initial portion of the wide-character string pointed to by
/// `nptr` to a type `long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn wcstol(
mut ptr: *const wchar_t,
end: *mut *mut wchar_t,
mut nptr: *const wchar_t,
endptr: *mut *mut wchar_t,
base: c_int,
) -> c_long {
skipws!(ptr);
let result = wcsto_impl!(c_long, ptr, base);
if !end.is_null() {
unsafe { *end = ptr.cast_mut() };
skipws!(nptr);
let result = wcsto_impl!(c_long, nptr, base);
if !endptr.is_null() {
unsafe { *endptr = nptr.cast_mut() };
}
result
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/wcstoll.html>.
///
/// Converts the initial portion of the wide-character string pointed to by
/// `nptr` to a type `long long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed, returns `0`.
#[expect(clippy::cast_lossless)] // not all users of `wcsto_impl!` are lossless
#[unsafe(no_mangle)]
pub unsafe extern "C" fn wcstoll(
mut ptr: *const wchar_t,
end: *mut *mut wchar_t,
mut nptr: *const wchar_t,
endptr: *mut *mut wchar_t,
base: c_int,
) -> c_longlong {
skipws!(ptr);
let result = wcsto_impl!(c_longlong, ptr, base);
if !end.is_null() {
unsafe { *end = ptr.cast_mut() };
skipws!(nptr);
let result = wcsto_impl!(c_longlong, nptr, base);
if !endptr.is_null() {
unsafe { *endptr = nptr.cast_mut() };
}
result
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/wcstoul.html>.
///
/// Converts the initial portion of the wide-character string pointed to by
/// `nptr` to a type `unsigned long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn wcstoul(
mut ptr: *const wchar_t,
end: *mut *mut wchar_t,
mut nptr: *const wchar_t,
endptr: *mut *mut wchar_t,
base: c_int,
) -> c_ulong {
skipws!(ptr);
let result = wcsto_impl!(c_ulong, ptr, base);
if !end.is_null() {
unsafe { *end = ptr.cast_mut() };
skipws!(nptr);
let result = wcsto_impl!(c_ulong, nptr, base);
if !endptr.is_null() {
unsafe { *endptr = nptr.cast_mut() };
}
result
}
/// See <https://pubs.opengroup.org/onlinepubs/9799919799/functions/wcstoull.html>.
///
/// Converts the initial portion of the wide-character string pointed to by
/// `nptr` to a type `unsigned long long`.
///
/// Upon success, returns the converted value. If no conversion could be
/// performed, returns `0`.
#[unsafe(no_mangle)]
pub unsafe extern "C" fn wcstoull(
mut ptr: *const wchar_t,
end: *mut *mut wchar_t,
mut nptr: *const wchar_t,
endptr: *mut *mut wchar_t,
base: c_int,
) -> c_ulonglong {
skipws!(ptr);
let result = wcsto_impl!(c_ulonglong, ptr, base);
if !end.is_null() {
unsafe { *end = ptr.cast_mut() };
skipws!(nptr);
let result = wcsto_impl!(c_ulonglong, nptr, base);
if !endptr.is_null() {
unsafe { *endptr = nptr.cast_mut() };
}
result
}