Enum Number 

pub enum Number {
    Int64(i64),
    UInt64(u64),
    Float64(f64),
    Decimal64(Decimal64),
    Decimal128(Decimal128),
    Decimal256(Decimal256),
}

Represents a JSON number with multiple possible internal representations.

This enum provides a unified type for JSON numbers while supporting various internal representations to optimize for different use cases:

• Integer types (signed/unsigned) for whole numbers
• Floating-point for scientific notation or fractional values
• Decimal types for exact decimal representation with different precision levels

The parser automatically selects the most appropriate representation based on the input value’s characteristics, allowing for both performance and precision.

Variants

Int64(i64)

64-bit signed integer, suitable for most whole numbers

UInt64(u64)

64-bit unsigned integer, for large positive whole numbers

Float64(f64)

64-bit floating-point, for scientific notation and approximate decimals

Decimal64(Decimal64)

64-bit decimal with exact precision, for financial calculations

Decimal128(Decimal128)

128-bit decimal with extended precision, for larger exact decimals

Decimal256(Decimal256)

256-bit decimal with maximum precision, for extremely large exact decimals

Trait Implementations

impl Clone for Number

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Number

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

Formats the value using the given formatter.

impl Default for Number

fn default() -> Self

Returns the default value for the Number enum.

The default value is Number::UInt64(0).

impl<'de> Deserialize<'de> for Number

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserializes a JSON number into the Number enum.

This implementation supports deserialization from JSON integers and floats. It automatically selects the most suitable internal representation based on the input value.

impl Display for Number

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

Formats the number as a string.

This method returns a string representation of the number in its internal format.

impl Eq for Number

impl Ord for Number

fn cmp(&self, other: &Self) -> Ordering

Returns the ordering of the number compared to another number.

This method implements precise comparison between different number types:

• When comparing decimal types with other types, it converts the non-decimal type to a decimal representation to preserve precision
• When comparing between decimal types of different precision, it upgrades the lower precision decimal to match the higher precision one
• Only falls back to floating-point comparison as a last resort

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Number

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

Returns true if the number is equal to another number.

This method compares the numbers using their internal representations.

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

Inequality operator !=.

impl PartialEq<&Number> for Number

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

Returns true if the number is equal to another number.

This method compares the numbers using their internal representations.

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

Inequality operator !=.

impl PartialEq<Number> for &Number

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

Returns true if the number is equal to another number.

This method compares the numbers using their internal representations.

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

Inequality operator !=.

impl PartialOrd for Number

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

Returns the ordering of the number compared to another number.

This method compares the numbers using their internal representations.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<&Number> for Number

fn partial_cmp(&self, other: &&Self) -> Option<Ordering>

Returns the ordering of the number compared to another number.

This method compares the numbers using their internal representations.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Number> for &Number

fn partial_cmp(&self, other: &Number) -> Option<Ordering>

Returns the ordering of the number compared to another number.

This method compares the numbers using their internal representations.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Number

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serializes the Number enum into a JSON number.

This implementation supports serialization to JSON integers and floats. Decimal types are converted to f64.