decimal-scaled 0.4.1

Const-generic base-10 fixed-point decimals (D9/D18/D38/D76/D153/D307) with integer-only transcendentals correctly rounded to within 0.5 ULP — exact at the type's last representable place. Deterministic across every platform; no_std-friendly.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

//! Narrow-tier floating-point power kernel — widen both base and
//! exponent to D38, `powf`, narrow back.
//!
//! Width-level specialisation for D9 / D18. Same pattern as
//! [`crate::algos::ln::widen_to_d38`], but the wrapper takes two values
//! (base and exponent) which are widened independently before the
//! kernel call.

use crate::types::widths::{D9, D18, D38};
use crate::support::rounding::RoundingMode;

/// `D9` powf via widen → D38 → narrow. Strict working-scale.
#[inline]
#[must_use]
pub(crate) fn powf_strict_d9<const SCALE: u32>(
    base: D9<SCALE>,
    exp: D9<SCALE>,
    mode: RoundingMode,
) -> D9<SCALE> {
    let base_w: D38<SCALE> = base.into();
    let exp_w: D38<SCALE> = exp.into();
    let raw = super::fixed_d38::powf_strict::<SCALE>(base_w.0, exp_w.0, mode);
    D38::<SCALE>::from_bits(raw)
        .try_into()
        .unwrap_or_else(|_| crate::support::diagnostics::overflow_panic_with_scale("powf_strict", SCALE))
}

/// `D9` powf with caller-chosen working digits.
#[inline]
#[must_use]
pub(crate) fn powf_with_d9<const SCALE: u32>(
    base: D9<SCALE>,
    exp: D9<SCALE>,
    working_digits: u32,
    mode: RoundingMode,
) -> D9<SCALE> {
    let base_w: D38<SCALE> = base.into();
    let exp_w: D38<SCALE> = exp.into();
    let raw = super::fixed_d38::powf_with::<SCALE>(base_w.0, exp_w.0, working_digits, mode);
    D38::<SCALE>::from_bits(raw)
        .try_into()
        .unwrap_or_else(|_| crate::support::diagnostics::overflow_panic_with_scale("powf_with", SCALE))
}

/// `D18` powf via widen → D38 → narrow. Strict working-scale.
#[inline]
#[must_use]
pub(crate) fn powf_strict_d18<const SCALE: u32>(
    base: D18<SCALE>,
    exp: D18<SCALE>,
    mode: RoundingMode,
) -> D18<SCALE> {
    let base_w: D38<SCALE> = base.into();
    let exp_w: D38<SCALE> = exp.into();
    let raw = super::fixed_d38::powf_strict::<SCALE>(base_w.0, exp_w.0, mode);
    D38::<SCALE>::from_bits(raw)
        .try_into()
        .unwrap_or_else(|_| crate::support::diagnostics::overflow_panic_with_scale("powf_strict", SCALE))
}

/// `D18` powf with caller-chosen working digits.
#[inline]
#[must_use]
pub(crate) fn powf_with_d18<const SCALE: u32>(
    base: D18<SCALE>,
    exp: D18<SCALE>,
    working_digits: u32,
    mode: RoundingMode,
) -> D18<SCALE> {
    let base_w: D38<SCALE> = base.into();
    let exp_w: D38<SCALE> = exp.into();
    let raw = super::fixed_d38::powf_with::<SCALE>(base_w.0, exp_w.0, working_digits, mode);
    D38::<SCALE>::from_bits(raw)
        .try_into()
        .unwrap_or_else(|_| crate::support::diagnostics::overflow_panic_with_scale("powf_with", SCALE))
}