Library / System / Conversions / NumberToDecimal
NumberToDecimal
Methods 4
METHOD numberParts(number v) RETURNS | DecimalPartsreads
number → decimal parts. An INTEGER subtype is exact (coefficient = store.i, exponent 0); a FLOAT subtype takes the Ryu shortest-decimal route (and so inherits its only failure mode — a non-finite float).
METHOD int128Parts(int128 v) RETURNS | DecimalPartsreads
int128 → decimal parts. Exact when the value fits decimal128's
34 significant digits (|v| < 10^34); a wider value FAILS rather than
silently rounding — the exact-or-fail INTO contract that keeps decimal128
from ever losing precision. coefficient = v directly (int128 → int128).
METHOD uint128Parts(uint128 v) RETURNS | DecimalPartsreads
uint128 → decimal parts. Exact when < 10^34; wider FAILS. The magnitude (< 2^113, so it fits a positive int128) is reassembled into the signed coefficient from its 64-bit halves — there is no uint128→int128 operator, and the low half is halved-then-doubled so the int64 reinterpret never goes negative (the DecimalCodec.bidToParts shape).
METHOD complexParts(complex v) RETURNS | DecimalPartsreads
complex → decimal parts. A complex projects onto a real decimal128 only
when its imaginary part is zero (there is no ordering or real embedding of
a genuinely-complex value); otherwise FAILURE. The real part is a number,
so it routes through numberParts.