Struct AncDec8 

pub struct AncDec8 { /* private fields */ }

8-bit fixed-point decimal (u8 int/frac, 2-digit precision, 4 bytes).

Stores integer and fractional parts as separate u8 values with an explicit scale (0-2).

Example

use ancdec::AncDec8;
let a: AncDec8 = "1.23".parse().unwrap();
assert_eq!(a.int(), 1);

Implementations

impl AncDec8

pub fn add(&self, other: &Self) -> Self

Adds two decimals, panics on integer overflow.

pub fn sub(&self, other: &Self) -> Self

Subtracts other from self, panics on integer overflow.

pub fn mul(&self, other: &Self) -> Self

Multiplies two decimals, panics on overflow.

pub fn div(&self, other: &Self) -> Self

Divides self by other, panics on division by zero.

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

Checked addition. Returns None if the integer part overflows u8.

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

Checked subtraction. Returns None if the integer part overflows u8.

In practice, subtraction in the current design uses magnitude comparison and cannot overflow, so this always returns Some.

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

Checked multiplication. Returns None if the result overflows u8 integer range.

pub fn rem(&self, other: &Self) -> Self

Computes the remainder (self % other), panics on division by zero.

impl AncDec8

pub fn abs(&self) -> Self

Returns the absolute value.

pub fn signum(&self) -> Self

Returns the sign: 1 for positive, -1 for negative, 0 for zero.

pub fn is_positive(&self) -> bool

Returns true if the value is strictly positive.

pub fn is_negative(&self) -> bool

Returns true if the value is strictly negative.

pub fn is_zero(&self) -> bool

Returns true if the value is zero.

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

Returns the smaller of self and other.

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

Returns the larger of self and other.

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

Clamps the value to the range [min, max].

pub fn sqrt(&self) -> Self

Returns the square root with 1 fractional digit of precision. Panics if negative.

pub fn pow(&self, n: i32) -> Self

Raises self to the power n using binary exponentiation. Supports negative exponents.

impl AncDec8

pub fn to_f64(&self) -> f64

Converts to f64 (may lose precision).

pub fn to_i64(&self) -> i64

Converts to i64, truncating the fractional part.

pub fn to_i128(&self) -> i128

Converts to i128, truncating the fractional part.

impl AncDec8

pub fn round(&self, decimal_places: u8, mode: RoundMode) -> Self

Rounds to the given number of decimal places using the specified mode.

pub fn floor(&self) -> Self

Returns the largest integer less than or equal to self.

pub fn ceil(&self) -> Self

Returns the smallest integer greater than or equal to self.

pub fn trunc(&self) -> Self

Returns the integer part, truncating toward zero.

pub fn fract(&self) -> Self

Returns the fractional part only.

impl AncDec8

pub const ZERO: AncDec8

The value 0.

pub const ONE: AncDec8

The value 1.

pub const TWO: AncDec8

The value 2.

pub const TEN: AncDec8

The value 10.

pub const MAX: AncDec8

The maximum representable value (255.99).

impl AncDec8

pub fn new(int: u8, frac: u8, scale: u8, neg: bool) -> Self

Creates a new AncDec8. Panics if scale > 2 or frac >= 10^scale.

pub fn int(&self) -> u8

Returns the integer part.

pub fn frac(&self) -> u8

Returns the fractional part as a raw value (0 to 10^scale - 1).

pub fn scale(&self) -> u8

Returns the number of fractional digits (0-2).

pub fn is_neg(&self) -> bool

Returns true if the value is negative.

impl AncDec8

pub fn parse<T: Display>(value: T) -> Result<Self, ParseError>

Parses any Display type into an AncDec8 using a stack buffer (no heap allocation).

Trait Implementations

impl<'b> Add<&'b AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the + operator.

fn add(self, rhs: &'b AncDec8) -> AncDec8

Performs the + operation.

impl<'a> Add<&'a AncDec8> for AncDec8

type Output = AncDec8

The resulting type after applying the + operator.

fn add(self, rhs: &'a AncDec8) -> AncDec8

Performs the + operation.

impl Add<AncDec> for AncDec8

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the + operator.

fn add(self, rhs: AncDec) -> AncDec

Performs the + operation.

impl Add<AncDec128> for AncDec8

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the + operator.

fn add(self, rhs: AncDec128) -> AncDec128

Performs the + operation.

impl Add<AncDec32> for AncDec8

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the + operator.

fn add(self, rhs: AncDec32) -> AncDec32

Performs the + operation.

impl Add<AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the + operator.

fn add(self, rhs: AncDec8) -> AncDec8

Performs the + operation.

impl Add<AncDec8> for AncDec

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the + operator.

fn add(self, rhs: AncDec8) -> AncDec

Performs the + operation.

impl Add<AncDec8> for AncDec128

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the + operator.

fn add(self, rhs: AncDec8) -> AncDec128

Performs the + operation.

impl Add<AncDec8> for AncDec32

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the + operator.

fn add(self, rhs: AncDec8) -> AncDec32

Performs the + operation.

impl Add<AncDec8> for i8

type Output = AncDec8

The resulting type after applying the + operator.

fn add(self, rhs: AncDec8) -> AncDec8

Performs the + operation.

impl Add<AncDec8> for u8

type Output = AncDec8

The resulting type after applying the + operator.

fn add(self, rhs: AncDec8) -> AncDec8

Performs the + operation.

impl Add<i8> for AncDec8

type Output = AncDec8

The resulting type after applying the + operator.

fn add(self, rhs: i8) -> AncDec8

Performs the + operation.

impl Add<u8> for AncDec8

type Output = AncDec8

The resulting type after applying the + operator.

fn add(self, rhs: u8) -> AncDec8

Performs the + operation.

impl Add for AncDec8

type Output = AncDec8

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for AncDec8

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for AncDec8

fn clone(&self) -> AncDec8

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AncDec8

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

Formats the value using the given formatter.

impl Default for AncDec8

fn default() -> Self

Returns the “default value” for a type.

impl Display for AncDec8

Display trait: enables format!, println!, to_string()

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

Formats the value using the given formatter.

impl<'b> Div<&'b AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the / operator.

fn div(self, rhs: &'b AncDec8) -> AncDec8

Performs the / operation.

impl<'a> Div<&'a AncDec8> for AncDec8

type Output = AncDec8

The resulting type after applying the / operator.

fn div(self, rhs: &'a AncDec8) -> AncDec8

Performs the / operation.

impl Div<AncDec> for AncDec8

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the / operator.

fn div(self, rhs: AncDec) -> AncDec

Performs the / operation.

impl Div<AncDec128> for AncDec8

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the / operator.

fn div(self, rhs: AncDec128) -> AncDec128

Performs the / operation.

impl Div<AncDec32> for AncDec8

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the / operator.

fn div(self, rhs: AncDec32) -> AncDec32

Performs the / operation.

impl Div<AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the / operator.

fn div(self, rhs: AncDec8) -> AncDec8

Performs the / operation.

impl Div<AncDec8> for AncDec

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the / operator.

fn div(self, rhs: AncDec8) -> AncDec

Performs the / operation.

impl Div<AncDec8> for AncDec128

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the / operator.

fn div(self, rhs: AncDec8) -> AncDec128

Performs the / operation.

impl Div<AncDec8> for AncDec32

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the / operator.

fn div(self, rhs: AncDec8) -> AncDec32

Performs the / operation.

impl Div<AncDec8> for i8

type Output = AncDec8

The resulting type after applying the / operator.

fn div(self, rhs: AncDec8) -> AncDec8

Performs the / operation.

impl Div<AncDec8> for u8

type Output = AncDec8

The resulting type after applying the / operator.

fn div(self, rhs: AncDec8) -> AncDec8

Performs the / operation.

impl Div<i8> for AncDec8

type Output = AncDec8

The resulting type after applying the / operator.

fn div(self, rhs: i8) -> AncDec8

Performs the / operation.

impl Div<u8> for AncDec8

type Output = AncDec8

The resulting type after applying the / operator.

fn div(self, rhs: u8) -> AncDec8

Performs the / operation.

impl Div for AncDec8

type Output = AncDec8

The resulting type after applying the / operator.

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

Performs the / operation.

impl DivAssign for AncDec8

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl From<AncDec8> for AncDec

Available on crate feature dec8 only.

Lossless widening from AncDec8 (u8) to AncDec (u64)

fn from(a: AncDec8) -> Self

Converts to this type from the input type.

impl From<AncDec8> for AncDec128

Available on crate feature dec8 only.

Lossless widening from AncDec8 (u8) to AncDec128 (u128)

fn from(a: AncDec8) -> Self

Converts to this type from the input type.

impl From<AncDec8> for AncDec32

Available on crate feature dec8 only.

Lossless widening from AncDec8 (u8) to AncDec32 (u32)

fn from(a: AncDec8) -> Self

Converts to this type from the input type.

impl From<i8> for AncDec8

fn from(n: i8) -> Self

Converts to this type from the input type.

impl From<u8> for AncDec8

fn from(n: u8) -> Self

Converts to this type from the input type.

impl FromStr for AncDec8

FromStr trait: enables "1.23".parse::<AncDec8>()

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for AncDec8

Normalizes trailing zeros so 1.0 == 1.00 have same hash Uses u16 combined value

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'b> Mul<&'b AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the * operator.

fn mul(self, rhs: &'b AncDec8) -> AncDec8

Performs the * operation.

impl<'a> Mul<&'a AncDec8> for AncDec8

type Output = AncDec8

The resulting type after applying the * operator.

fn mul(self, rhs: &'a AncDec8) -> AncDec8

Performs the * operation.

impl Mul<AncDec> for AncDec8

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec) -> AncDec

Performs the * operation.

impl Mul<AncDec128> for AncDec8

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec128) -> AncDec128

Performs the * operation.

impl Mul<AncDec32> for AncDec8

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec32) -> AncDec32

Performs the * operation.

impl Mul<AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec8) -> AncDec8

Performs the * operation.

impl Mul<AncDec8> for AncDec

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec8) -> AncDec

Performs the * operation.

impl Mul<AncDec8> for AncDec128

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec8) -> AncDec128

Performs the * operation.

impl Mul<AncDec8> for AncDec32

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec8) -> AncDec32

Performs the * operation.

impl Mul<AncDec8> for i8

type Output = AncDec8

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec8) -> AncDec8

Performs the * operation.

impl Mul<AncDec8> for u8

type Output = AncDec8

The resulting type after applying the * operator.

fn mul(self, rhs: AncDec8) -> AncDec8

Performs the * operation.

impl Mul<i8> for AncDec8

type Output = AncDec8

The resulting type after applying the * operator.

fn mul(self, rhs: i8) -> AncDec8

Performs the * operation.

impl Mul<u8> for AncDec8

type Output = AncDec8

The resulting type after applying the * operator.

fn mul(self, rhs: u8) -> AncDec8

Performs the * operation.

impl Mul for AncDec8

type Output = AncDec8

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign for AncDec8

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Neg for &AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

fn neg(self) -> AncDec8

Performs the unary - operation.

impl Neg for AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl Ord for AncDec8

Ord trait

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 AncDec8

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 AncDec8

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<'a> Product<&'a AncDec8> for AncDec8

fn product<I: Iterator<Item = &'a Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by multiplying the items.

impl Product for AncDec8

fn product<I: Iterator<Item = Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by multiplying the items.

impl<'b> Rem<&'b AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the % operator.

fn rem(self, rhs: &'b AncDec8) -> AncDec8

Performs the % operation.

impl<'a> Rem<&'a AncDec8> for AncDec8

type Output = AncDec8

The resulting type after applying the % operator.

fn rem(self, rhs: &'a AncDec8) -> AncDec8

Performs the % operation.

impl Rem<AncDec> for AncDec8

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the % operator.

fn rem(self, rhs: AncDec) -> AncDec

Performs the % operation.

impl Rem<AncDec128> for AncDec8

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the % operator.

fn rem(self, rhs: AncDec128) -> AncDec128

Performs the % operation.

impl Rem<AncDec32> for AncDec8

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the % operator.

fn rem(self, rhs: AncDec32) -> AncDec32

Performs the % operation.

impl Rem<AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the % operator.

fn rem(self, rhs: AncDec8) -> AncDec8

Performs the % operation.

impl Rem<AncDec8> for AncDec

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the % operator.

fn rem(self, rhs: AncDec8) -> AncDec

Performs the % operation.

impl Rem<AncDec8> for AncDec128

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the % operator.

fn rem(self, rhs: AncDec8) -> AncDec128

Performs the % operation.

impl Rem<AncDec8> for AncDec32

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the % operator.

fn rem(self, rhs: AncDec8) -> AncDec32

Performs the % operation.

impl Rem for AncDec8

type Output = AncDec8

The resulting type after applying the % operator.

fn rem(self, rhs: Self) -> Self

Performs the % operation.

impl RemAssign for AncDec8

fn rem_assign(&mut self, rhs: Self)

Performs the %= operation.

impl<'b> Sub<&'b AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

fn sub(self, rhs: &'b AncDec8) -> AncDec8

Performs the - operation.

impl<'a> Sub<&'a AncDec8> for AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

fn sub(self, rhs: &'a AncDec8) -> AncDec8

Performs the - operation.

impl Sub<AncDec> for AncDec8

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec) -> AncDec

Performs the - operation.

impl Sub<AncDec128> for AncDec8

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec128) -> AncDec128

Performs the - operation.

impl Sub<AncDec32> for AncDec8

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec32) -> AncDec32

Performs the - operation.

impl Sub<AncDec8> for &AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec8) -> AncDec8

Performs the - operation.

impl Sub<AncDec8> for AncDec

Available on crate features dec8 and dec64 only.

type Output = AncDec

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec8) -> AncDec

Performs the - operation.

impl Sub<AncDec8> for AncDec128

Available on crate features dec8 and dec128 only.

type Output = AncDec128

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec8) -> AncDec128

Performs the - operation.

impl Sub<AncDec8> for AncDec32

Available on crate features dec8 and dec32 only.

type Output = AncDec32

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec8) -> AncDec32

Performs the - operation.

impl Sub<AncDec8> for i8

type Output = AncDec8

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec8) -> AncDec8

Performs the - operation.

impl Sub<AncDec8> for u8

type Output = AncDec8

The resulting type after applying the - operator.

fn sub(self, rhs: AncDec8) -> AncDec8

Performs the - operation.

impl Sub<i8> for AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

fn sub(self, rhs: i8) -> AncDec8

Performs the - operation.

impl Sub<u8> for AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

fn sub(self, rhs: u8) -> AncDec8

Performs the - operation.

impl Sub for AncDec8

type Output = AncDec8

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for AncDec8

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl<'a> Sum<&'a AncDec8> for AncDec8

fn sum<I: Iterator<Item = &'a Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by “summing up” the items.

impl Sum for AncDec8

fn sum<I: Iterator<Item = Self>>(iter: I) -> Self

Takes an iterator and generates Self from the elements by “summing up” the items.

impl TryFrom<&str> for AncDec8

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<f32> for AncDec8

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(n: f32) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<f64> for AncDec8

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(n: f64) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for AncDec8

impl Eq for AncDec8