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

Implementations

impl Number

pub fn as_i128(&self) -> Option<i128>

Returns the i128 representation of the number, if possible.

This method returns None if the number cannot be represented as an i64.

pub fn as_i64(&self) -> Option<i64>

Returns the i64 representation of the number, if possible.

This method returns None if the number cannot be represented as an i64.

pub fn as_u64(&self) -> Option<u64>

Returns the u64 representation of the number, if possible.

This method returns None if the number cannot be represented as a u64.

pub fn as_f64(&self) -> f64

Returns the f64 representation of the number.

This method always returns a value, but may lose precision for very large numbers.

pub fn neg(&self) -> Result<Number, Error>

Returns the negation of the number.

This method returns an error if the negation would overflow.

pub fn add(&self, other: Number) -> Result<Number, Error>

Returns the sum of the number and another number.

This method returns an error if the sum would overflow.

pub fn sub(&self, other: Number) -> Result<Number, Error>

Returns the difference of the number and another number.

This method returns an error if the difference would overflow.

pub fn mul(&self, other: Number) -> Result<Number, Error>

Returns the product of the number and another number.

This method returns an error if the product would overflow.

pub fn div(&self, other: Number) -> Result<Number, Error>

Returns the quotient of the number and another number.

This method returns an error if the divisor is zero.

pub fn rem(&self, other: Number) -> Result<Number, Error>

Returns the remainder of the number divided by another number.

This method returns an error if the divisor is zero.

Trait Implementations

impl Clone for Number

fn clone(&self) -> Number

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 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.

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

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

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

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

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

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

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 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 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 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. It automatically selects the most suitable output format based on the internal representation.

When the arbitrary_precision feature is enabled, decimal types are serialized with full precision using the optimized formatting functions. When disabled, decimal types are converted to f64.

impl Eq for Number