Struct SignedNumeric 

pub struct SignedNumeric {
    pub value: UnsignedNumeric,
    pub is_negative: bool,
}

A SignedNumeric represents a signed 192-bit fixed-point number with 18 decimal places of precision.

This struct extends UnsignedNumeric by adding a bool flag to indicate whether the value is negative, enabling full support for signed decimal arithmetic.

Internal Representation

• The magnitude is stored as a UnsignedNumeric, which wraps a [InnerUint] representing a 192-bit unsigned integer scaled by 10¹⁸.
• The is_negative flag determines the sign of the number.

Interpretation

The real-world value of a SignedNumeric is:

value = (is_negative ? -1 : 1) × (magnitude / 10^18)

Examples:

• value = UnsignedNumeric::from_u192([1_000_000_000_000_000_000, 0, 0]), is_negative = false → 1.0
• value = UnsignedNumeric::from_u192([5_000_000_000_000_000_000, 0, 0]), is_negative = true → -5.0

This format is useful for financial and scientific applications where both precision and sign are critical, and where floating-point inaccuracies are unacceptable.

Fields

value: UnsignedNumeric

is_negative: bool

Implementations

impl SignedNumeric

pub fn new(value: i128) -> Self

pub fn negate(&self) -> SignedNumeric

pub fn checked_mul(&self, rhs: &Self) -> Option<SignedNumeric>

pub fn checked_div(&self, rhs: &Self) -> Option<SignedNumeric>

pub fn checked_add(&self, rhs: &Self) -> Option<SignedNumeric>

pub fn checked_sub(&self, rhs: &Self) -> Option<SignedNumeric>

pub fn floor(&self) -> Option<SignedNumeric>

pub fn to_string(&self) -> String

impl SignedNumeric

pub fn exp(&self) -> Option<UnsignedNumeric>

Calculate the exponential of x, that is, e raised to the power x (where e is the base of the natural system of logarithms, approximately 2.71828). Note that precision can start to get inaccurate for larger numbers (> 20).

pub fn sqrt(&self) -> Option<Self>

Returns the square root of self, returning None if the number is negative.

Trait Implementations

impl Add<&SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&SignedNumeric> for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the + operator.

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

Performs the + operation.

impl Clone for SignedNumeric

fn clone(&self) -> SignedNumeric

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SignedNumeric

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

Formats the value using the given formatter.

impl Div<&SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<&SignedNumeric> for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the / operator.

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

Performs the / operation.

impl Mul<&SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<&SignedNumeric> for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the * operator.

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

Performs the * operation.

impl PartialEq for SignedNumeric

fn eq(&self, other: &SignedNumeric) -> 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 Sub<&SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&SignedNumeric> for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<SignedNumeric> for &SignedNumeric

type Output = SignedNumeric

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for SignedNumeric

type Output = SignedNumeric

The resulting type after applying the - operator.

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

Performs the - operation.

impl StructuralPartialEq for SignedNumeric