Struct SmallDecimal 

pub struct SmallDecimal {
    pub value: i64,
    pub scale: i16,
    pub negative: bool,
}

Small decimal structure for parsing/formatting without floats This avoids floating-point precision issues for financial data

Fields

value: i64

The integer value (unscaled)

scale: i16

The scale (number of decimal places)

negative: bool

Whether the value is negative

Implementations

impl SmallDecimal

pub fn new(value: i64, scale: i16, negative: bool) -> Self

Create a new SmallDecimal.

pub fn zero(scale: i16) -> Self

Create a zero value with the given scale

pub fn normalize(&mut self)

Normalize -0 to 0 (NORMATIVE)

pub fn to_string(&self) -> String

Format as string with fixed scale (NORMATIVE)

Always render with exactly scale digits after decimal point.

pub fn from_str(s: &str, expected_scale: i16) -> Result<Self>

Parse a decimal string into a SmallDecimal using the expected scale.

Errors

Returns an error when the text violates the expected numeric format.

pub fn to_fixed_scale_string(&self, scale: i16) -> String

Format as string with the given fixed scale.

Always renders with exactly scale digits after the decimal point, independent of the SmallDecimal’s own scale. Used for lossless JSON output.

pub fn format_to_scratch_buffer(&self, scale: i16, scratch_buffer: &mut String)

Format the decimal into a caller-owned string buffer to avoid allocation.

This is the hot-path formatter used in COMP-3 JSON conversion. The buffer is cleared before writing.

pub fn scale(&self) -> i16

Get the scale of this decimal

pub fn is_negative(&self) -> bool

Check if this decimal is negative

pub fn total_digits(&self) -> u16

Get the total number of digits in this decimal

Trait Implementations

impl Clone for SmallDecimal

fn clone(&self) -> SmallDecimal

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SmallDecimal

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for SmallDecimal

fn eq(&self, other: &SmallDecimal) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SmallDecimal

impl StructuralPartialEq for SmallDecimal