Struct Amount

pub struct Amount { /* private fields */ }

Fractal Global Credits amount

This struct can be used the same way as any other number. An Amount can be added or substracted to another Amount, and it can be divided and multiplied by an integer. All operations that are defined in the Amount scope and that are exact can be used directly as usual integer / float point operations.

No negative amounts can exist, since an Amount is unsigned, sothe negation operator ‘-’, then, has no use with an Amount.

Its internal representation is a 64 bit unsigned number, that is displayed as a fixed point, number of factor 1/1,000. This means that an internal representation of 1,000 would be an external amount of 1. The internal representation shouldn’t be used except when serializing and deserializing the data, since this type is sent in JSON as its internal u64.

The use is the following:

use fractal_utils::Amount;

let amount = Amount::from_repr(1_654); // 1.654
let ten = Amount::from_repr(10_000); // 10
let add_ten = amount + ten;
assert_eq!(add_ten, Amount::from_repr(11_654)); // 11.654

They can be divided and multiplied by any other unsigned integer:

let mut amount = Amount::from_repr(7_000); // 7
amount *= 10u32;
assert_eq!(amount, Amount::from_repr(70_000)); // 70

amount = amount / 30u16;
assert_eq!(amount, Amount::from_repr(2_333)); // 2.333

amount %= 1u8;
assert_eq!(amount, Amount::from_repr(333)); // 0.333

Amounts can easily be displayed using the Display trait as any other number:

let amount = Amount::from_repr(56_000);
assert_eq!(format!("{}", amount), "56");
assert_eq!(format!("{:.2}", amount), "56.00");
assert_eq!(format!("{:.5}", amount), "56.00000");
assert_eq!(format!("{:05.1}", amount), "056.0");

// And with rounding:
let amount = Amount::from_repr(56); // 0.056
assert_eq!(format!("{:.2}", amount), "0.06");

Implementations

impl Amount

pub fn from_repr(value: u64) -> Amount

Creates a new amount from its internal representation.

pub fn get_repr(&self) -> u64

Gets the internal representation of the amount.

pub fn min_value() -> Amount

Returns the smallest value that can be represented as a currency amount.

pub fn max_value() -> Amount

Returns the largest value that can be represented as a currency amount.

Trait Implementations

impl Add for Amount

type Output = Amount

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for Amount

fn add_assign(&mut self, rhs: Amount)

Performs the += operation.

impl Clone for Amount

fn clone(&self) -> Amount

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Amount

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

Formats the value using the given formatter.

impl Decodable for Amount

fn decode<D: Decoder>(d: &mut D) -> Result<Amount, D::Error>

Deserialize a value using a Decoder.

impl Display for Amount

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

Formats the value using the given formatter.

impl Div<u16> for Amount

type Output = Amount

The resulting type after applying the / operator.

fn div(self, rhs: u16) -> Amount

Performs the / operation.

impl Div<u32> for Amount

type Output = Amount

The resulting type after applying the / operator.

fn div(self, rhs: u32) -> Amount

Performs the / operation.

impl Div<u64> for Amount

type Output = Amount

The resulting type after applying the / operator.

fn div(self, rhs: u64) -> Amount

Performs the / operation.

impl Div<u8> for Amount

type Output = Amount

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<usize> for Amount

type Output = Amount

The resulting type after applying the / operator.

fn div(self, rhs: usize) -> Amount

Performs the / operation.

impl DivAssign<u16> for Amount

fn div_assign(&mut self, rhs: u16)

Performs the /= operation.

impl DivAssign<u32> for Amount

fn div_assign(&mut self, rhs: u32)

Performs the /= operation.

impl DivAssign<u64> for Amount

fn div_assign(&mut self, rhs: u64)

Performs the /= operation.

impl DivAssign<u8> for Amount

fn div_assign(&mut self, rhs: u8)

Performs the /= operation.

impl DivAssign<usize> for Amount

fn div_assign(&mut self, rhs: usize)

Performs the /= operation.

impl Encodable for Amount

fn encode<S: Encoder>(&self, s: &mut S) -> Result<(), S::Error>

Serialize a value using an Encoder.

impl FromStr for Amount

type Err = AmountParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Amount, AmountParseError>

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

impl Mul<Amount> for u16

type Output = Amount

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Amount> for u32

type Output = Amount

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Amount> for u64

type Output = Amount

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Amount> for u8

type Output = Amount

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Amount> for usize

type Output = Amount

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<u16> for Amount

type Output = Amount

The resulting type after applying the * operator.

fn mul(self, rhs: u16) -> Amount

Performs the * operation.

impl Mul<u32> for Amount

type Output = Amount

The resulting type after applying the * operator.

fn mul(self, rhs: u32) -> Amount

Performs the * operation.

impl Mul<u64> for Amount

type Output = Amount

The resulting type after applying the * operator.

fn mul(self, rhs: u64) -> Amount

Performs the * operation.

impl Mul<u8> for Amount

type Output = Amount

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<usize> for Amount

type Output = Amount

The resulting type after applying the * operator.

fn mul(self, rhs: usize) -> Amount

Performs the * operation.

impl MulAssign<u16> for Amount

fn mul_assign(&mut self, rhs: u16)

Performs the *= operation.

impl MulAssign<u32> for Amount

fn mul_assign(&mut self, rhs: u32)

Performs the *= operation.

impl MulAssign<u64> for Amount

fn mul_assign(&mut self, rhs: u64)

Performs the *= operation.

impl MulAssign<u8> for Amount

fn mul_assign(&mut self, rhs: u8)

Performs the *= operation.

impl MulAssign<usize> for Amount

fn mul_assign(&mut self, rhs: usize)

Performs the *= operation.

impl Ord for Amount

fn cmp(&self, other: &Amount) -> 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 Amount

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

fn partial_cmp(&self, other: &Amount) -> 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 Rem<u16> for Amount

type Output = Amount

The resulting type after applying the % operator.

fn rem(self, rhs: u16) -> Amount

Performs the % operation.

impl Rem<u32> for Amount

type Output = Amount

The resulting type after applying the % operator.

fn rem(self, rhs: u32) -> Amount

Performs the % operation.

impl Rem<u64> for Amount

type Output = Amount

The resulting type after applying the % operator.

fn rem(self, rhs: u64) -> Amount

Performs the % operation.

impl Rem<u8> for Amount

type Output = Amount

The resulting type after applying the % operator.

fn rem(self, rhs: u8) -> Amount

Performs the % operation.

impl Rem<usize> for Amount

type Output = Amount

The resulting type after applying the % operator.

fn rem(self, rhs: usize) -> Amount

Performs the % operation.

impl RemAssign<u16> for Amount

fn rem_assign(&mut self, rhs: u16)

Performs the %= operation.

impl RemAssign<u32> for Amount

fn rem_assign(&mut self, rhs: u32)

Performs the %= operation.

impl RemAssign<u64> for Amount

fn rem_assign(&mut self, rhs: u64)

Performs the %= operation.

impl RemAssign<u8> for Amount

fn rem_assign(&mut self, rhs: u8)

Performs the %= operation.

impl RemAssign<usize> for Amount

fn rem_assign(&mut self, rhs: usize)

Performs the %= operation.

impl Sub for Amount

type Output = Amount

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for Amount

fn sub_assign(&mut self, rhs: Amount)

Performs the -= operation.

impl Copy for Amount

impl Eq for Amount

impl StructuralPartialEq for Amount