Struct Number 

pub struct Number { /* private fields */ }

High-precision decimal number

Implementations

impl Number

pub fn new() -> Self

Create a new Number initialized to zero

pub fn from_i64(mantissa: i64) -> Result<Self, NumberError>

Create a Number from an i64 mantissa

pub fn from_mantissa_exponent( mantissa: i64, exponent: i32, ) -> Result<Self, NumberError>

Create a Number from mantissa and exponent

pub fn from_xrpl_iou_value(buffer: XrplIouValue) -> Result<Self, NumberError>

Create a Number from an XRP Ledger IOU value (8-byte buffer)

Parses the XRP Ledger token amount format:

• Bit 0 (MSB): Type bit (1=token, 0=XRP)
• Bit 1: Sign bit (1=positive, 0=negative)
• Bits 2-9: Exponent (unsigned, add 97 to get actual exponent in range -96 to +80)
• Bits 10-63: Mantissa (54 bits, normalized to 10^15 to 10^16-1)

pub fn to_xrpl_iou_value(&self) -> Result<XrplIouValue, NumberError>

Convert this Number to an XRP Ledger IOU value (8-byte buffer)

Serializes to the XRP Ledger token amount format:

• Bit 0 (MSB): Type bit (1=token, 0=XRP)
• Bit 1: Sign bit (1=positive, 0=negative)
• Bits 2-9: Exponent (unsigned, add 97 to get actual exponent in range -96 to +80)
• Bits 10-63: Mantissa (54 bits, normalized to 10^15 to 10^16-1)

pub fn mantissa(&self) -> i64

Get the mantissa of this Number

pub fn exponent(&self) -> i32

Get the exponent of this Number

pub fn to_i64(&self) -> Result<i64, NumberError>

Convert to i64 (with potential precision loss)

pub fn signum(&self) -> i32

Get the sign of this Number (-1, 0, or 1)

pub fn is_zero(&self) -> bool

Check if this Number is zero

pub fn abs(&self) -> Result<Self, NumberError>

Compute absolute value

pub fn pow(&self, exponent: u32) -> Result<Self, NumberError>

Raise this Number to an unsigned integer power

pub fn root(&self, degree: u32) -> Result<Self, NumberError>

Compute the nth root of this Number

pub fn sqrt(&self) -> Result<Self, NumberError>

Compute the square root of this Number

pub fn log10(&self) -> Result<Self, NumberError>

Compute the base-10 logarithm of this Number

pub fn get_rounding_mode() -> RoundingMode

Get the current global rounding mode

pub fn set_rounding_mode(mode: RoundingMode) -> RoundingMode

Set the global rounding mode, returning the previous mode

pub fn min() -> Self

Get the minimum representable Number

pub fn max() -> Self

Get the maximum representable Number

pub fn lowest() -> Self

Get the lowest (most negative) representable Number

Trait Implementations

impl Add for &Number

type Output = Result<Number, NumberError>

The resulting type after applying the + operator.

fn add(self, rhs: &Number) -> Self::Output

Performs the + operation.

impl Add for Number

type Output = Result<Number, NumberError>

The resulting type after applying the + operator.

fn add(self, rhs: Number) -> Self::Output

Performs the + operation.

impl AddAssign<&Number> for Number

fn add_assign(&mut self, rhs: &Number)

Performs the += operation.

impl AddAssign for Number

fn add_assign(&mut self, rhs: Number)

Performs the += operation.

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

impl Display for Number

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

Formats the value using the given formatter.

impl Div for &Number

type Output = Result<Number, NumberError>

The resulting type after applying the / operator.

fn div(self, rhs: &Number) -> Self::Output

Performs the / operation.

impl Div for Number

type Output = Result<Number, NumberError>

The resulting type after applying the / operator.

fn div(self, rhs: Number) -> Self::Output

Performs the / operation.

impl DivAssign<&Number> for Number

fn div_assign(&mut self, rhs: &Number)

Performs the /= operation.

impl DivAssign for Number

fn div_assign(&mut self, rhs: Number)

Performs the /= operation.

impl Drop for Number

fn drop(&mut self)

Executes the destructor for this type.

impl From<i64> for Number

fn from(value: i64) -> Self

Converts to this type from the input type.

impl Mul for &Number

type Output = Result<Number, NumberError>

The resulting type after applying the * operator.

fn mul(self, rhs: &Number) -> Self::Output

Performs the * operation.

impl Mul for Number

type Output = Result<Number, NumberError>

The resulting type after applying the * operator.

fn mul(self, rhs: Number) -> Self::Output

Performs the * operation.

impl MulAssign<&Number> for Number

fn mul_assign(&mut self, rhs: &Number)

Performs the *= operation.

impl MulAssign for Number

fn mul_assign(&mut self, rhs: Number)

Performs the *= operation.

impl Neg for &Number

type Output = Result<Number, NumberError>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Neg for Number

type Output = Result<Number, NumberError>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Ord for Number

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

This method returns an Ordering between self and other.

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 for Number

fn eq(&self, other: &Self) -> 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 PartialOrd for Number

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

This method returns an ordering between self and other values if one exists.

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 Sub for &Number

type Output = Result<Number, NumberError>

The resulting type after applying the - operator.

fn sub(self, rhs: &Number) -> Self::Output

Performs the - operation.

impl Sub for Number

type Output = Result<Number, NumberError>

The resulting type after applying the - operator.

fn sub(self, rhs: Number) -> Self::Output

Performs the - operation.

impl SubAssign<&Number> for Number

fn sub_assign(&mut self, rhs: &Number)

Performs the -= operation.

impl SubAssign for Number

fn sub_assign(&mut self, rhs: Number)

Performs the -= operation.

impl TryFrom<&Number> for XrplIouValue

type Error = NumberError

The type returned in the event of a conversion error.

fn try_from(number: &Number) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<[u8; 8]> for Number

type Error = NumberError

The type returned in the event of a conversion error.

fn try_from(buffer: XrplIouValue) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Number> for XrplIouValue

type Error = NumberError

The type returned in the event of a conversion error.

fn try_from(number: Number) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Number

impl Send for Number

impl Sync for Number