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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

//! Cube-root policy — same cascade shape as [`crate::policy::sqrt`].

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

/// Per-width policy: which kernel a `Dxx<SCALE>` uses for
/// `cbrt_strict_with`. See [`crate::policy`] module docs for the
/// cascade structure.
pub(crate) trait CbrtPolicy: Sized {
    /// Cube root under the supplied rounding mode. Sign is preserved.
    fn cbrt_impl(self, mode: RoundingMode) -> Self;
}

// ── Narrow tier — width override: widen → D38 ───────────────────────

impl<const SCALE: u32> CbrtPolicy for D9<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        cbrt::widen_to_d38::cbrt_d9(self, mode)
    }
}

impl<const SCALE: u32> CbrtPolicy for D18<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        cbrt::widen_to_d38::cbrt_d18(self, mode)
    }
}

// ── D38 — width override: hand-tuned 384-bit cube root ─────────────

impl<const SCALE: u32> CbrtPolicy for D38<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::mg_divide_d38::cbrt(self.0, SCALE, mode))
    }
}

// ── Wide tiers — width default: generic_wide ───────────────────────

#[cfg(any(feature = "d57", feature = "wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D57<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        // Scale-range slot reserved for D57<20> tuning (none yet).
        Self(cbrt::generic_wide::cbrt_d57(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d76", feature = "wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D76<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d76(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d115", feature = "wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D115<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d115(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d153", feature = "wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D153<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d153(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d230", feature = "wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D230<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d230(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d307", feature = "wide", feature = "x-wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D307<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d307(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d462", feature = "x-wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D462<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d462(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d616", feature = "x-wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D616<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d616(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d924", feature = "xx-wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D924<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d924(self.0, SCALE, mode))
    }
}

#[cfg(any(feature = "d1232", feature = "xx-wide"))]
impl<const SCALE: u32> CbrtPolicy for crate::types::widths::D1232<SCALE> {
    #[inline]
    fn cbrt_impl(self, mode: RoundingMode) -> Self {
        Self(cbrt::generic_wide::cbrt_d1232(self.0, SCALE, mode))
    }
}