Struct Money

pub struct Money<'a, T: FormattableCurrency> { /* private fields */ }

Represents an amount of a given currency.

Money represents financial amounts through a Decimal (owned) and a Currency (refernce). Operations on Money objects always create new instances of Money, with the exception of round().

Implementations

impl<'a, T: FormattableCurrency> Money<'a, T>

pub fn from_str( amount: &str, currency: &'a T, ) -> Result<Money<'a, T>, MoneyError>

Creates a Money object given an amount string and a currency str.

Supports fuzzy amount strings like “100”, “100.00” and “-100.00”

pub fn from_minor(amount: i64, currency: &'a T) -> Money<'a, T>

Creates a Money object given an integer and a currency reference.

The integer represents minor units of the currency (e.g. 1000 -> 10.00 in USD )

pub fn from_major(amount: i64, currency: &'a T) -> Money<'a, T>

Creates a Money object given an integer and a currency reference.

The integer represents major units of the currency (e.g. 1000 -> 1,000 in USD )

pub fn from_decimal(amount: Decimal, currency: &'a T) -> Money<'a, T>

Creates a Money object given a decimal amount and a currency reference.

pub fn amount(&self) -> &Decimal

Returns a reference to the Decimal amount.

pub fn currency(&self) -> &'a T

Returns the Currency type.

pub fn is_zero(&self) -> bool

Returns true if amount == 0.

pub fn is_positive(&self) -> bool

Returns true if amount > 0.

pub fn is_negative(&self) -> bool

Returns true if amount < 0.

pub fn allocate_to(&self, number: i32) -> Result<Vec<Money<'a, T>>, MoneyError>

Divides money equally into n shares.

If the divison cannot be applied perfectly, it allocates the remainder to some of the shares.

pub fn allocate( &self, ratios: Vec<i32>, ) -> Result<Vec<Money<'a, T>>, MoneyError>

Divides money into n shares according to a particular ratio.

If the divison cannot be applied perfectly, it allocates the remainder to some of the shares.

pub fn round(&self, digits: u32, strategy: Round) -> Money<'a, T>

Returns a Money rounded to the specified number of minor units using the rounding strategy.

Trait Implementations

impl<'a, T: FormattableCurrency> Add for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the + operator.

fn add(self, other: Money<'a, T>) -> Money<'a, T>

Performs the + operation.

impl<'a, T: FormattableCurrency> AddAssign for Money<'a, T>

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<'a, T: Clone + FormattableCurrency> Clone for Money<'a, T>

fn clone(&self) -> Money<'a, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, T: Debug + FormattableCurrency> Debug for Money<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: FormattableCurrency> Display for Money<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: FormattableCurrency> Div<Decimal> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Decimal) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for Decimal

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for i16

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for i32

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for i64

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for i8

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for isize

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for u16

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for u32

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for u64

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for u8

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<Money<'a, T>> for usize

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<i16> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: i16) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<i32> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: i32) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<i64> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: i64) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<i8> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: i8) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<isize> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: isize) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<u16> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: u16) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<u32> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: u32) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<u64> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: u64) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<u8> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: u8) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> Div<usize> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the / operator.

fn div(self, rhs: usize) -> Money<'a, T>

Performs the / operation.

impl<'a, T: FormattableCurrency> DivAssign<Decimal> for Money<'a, T>

fn div_assign(&mut self, rhs: Decimal)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<i16> for Money<'a, T>

fn div_assign(&mut self, rhs: i16)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<i32> for Money<'a, T>

fn div_assign(&mut self, rhs: i32)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<i64> for Money<'a, T>

fn div_assign(&mut self, rhs: i64)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<i8> for Money<'a, T>

fn div_assign(&mut self, rhs: i8)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<isize> for Money<'a, T>

fn div_assign(&mut self, rhs: isize)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<u16> for Money<'a, T>

fn div_assign(&mut self, rhs: u16)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<u32> for Money<'a, T>

fn div_assign(&mut self, rhs: u32)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<u64> for Money<'a, T>

fn div_assign(&mut self, rhs: u64)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<u8> for Money<'a, T>

fn div_assign(&mut self, rhs: u8)

Performs the /= operation.

impl<'a, T: FormattableCurrency> DivAssign<usize> for Money<'a, T>

fn div_assign(&mut self, rhs: usize)

Performs the /= operation.

impl<'a, T: FormattableCurrency> Mul<Decimal> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Decimal) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for Decimal

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for i16

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for i32

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for i64

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for i8

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for isize

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for u16

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for u32

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for u64

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for u8

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<Money<'a, T>> for usize

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: Money<'a, T>) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<i16> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: i16) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<i32> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: i32) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<i64> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: i64) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<i8> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: i8) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<isize> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: isize) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<u16> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: u16) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<u32> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: u32) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<u64> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: u64) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<u8> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: u8) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> Mul<usize> for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the * operator.

fn mul(self, rhs: usize) -> Money<'a, T>

Performs the * operation.

impl<'a, T: FormattableCurrency> MulAssign<Decimal> for Money<'a, T>

fn mul_assign(&mut self, rhs: Decimal)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<i16> for Money<'a, T>

fn mul_assign(&mut self, rhs: i16)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<i32> for Money<'a, T>

fn mul_assign(&mut self, rhs: i32)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<i64> for Money<'a, T>

fn mul_assign(&mut self, rhs: i64)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<i8> for Money<'a, T>

fn mul_assign(&mut self, rhs: i8)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<isize> for Money<'a, T>

fn mul_assign(&mut self, rhs: isize)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<u16> for Money<'a, T>

fn mul_assign(&mut self, rhs: u16)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<u32> for Money<'a, T>

fn mul_assign(&mut self, rhs: u32)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<u64> for Money<'a, T>

fn mul_assign(&mut self, rhs: u64)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<u8> for Money<'a, T>

fn mul_assign(&mut self, rhs: u8)

Performs the *= operation.

impl<'a, T: FormattableCurrency> MulAssign<usize> for Money<'a, T>

fn mul_assign(&mut self, rhs: usize)

Performs the *= operation.

impl<'a, T: FormattableCurrency> Ord for Money<'a, T>

fn cmp(&self, other: &Money<'a, T>) -> 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<'a, T: PartialEq + FormattableCurrency> PartialEq for Money<'a, T>

fn eq(&self, other: &Money<'a, T>) -> 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<'a, T: FormattableCurrency> PartialOrd for Money<'a, T>

fn partial_cmp(&self, other: &Money<'a, T>) -> 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, T: FormattableCurrency> Sub for Money<'a, T>

type Output = Money<'a, T>

The resulting type after applying the - operator.

fn sub(self, other: Money<'a, T>) -> Money<'a, T>

Performs the - operation.

impl<'a, T: FormattableCurrency> SubAssign for Money<'a, T>

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl<'a, T: Eq + FormattableCurrency> Eq for Money<'a, T>

impl<'a, T: FormattableCurrency> StructuralPartialEq for Money<'a, T>