Skip to main content

Currency

Struct Currency 

Source
pub struct Currency { /* private fields */ }
Expand description

How a money column spells its amounts: the symbol, where it goes, the decimals, and whether the field stores minor units.

use tablo_core::Currency;

assert_eq!(Currency::USD.format(1234.5), "$1,234.50");
assert_eq!(Currency::EUR.format(1234.5), "€1,234.50");
assert_eq!(
    Currency::new("CHF").symbol_after().format(-3.0),
    "-3.00 CHF"
);
assert_eq!(Currency::USD.minor_units().format(123_456), "$1,234.56");

format spells English; a column spells the request’s locale through format_in: its catalog’s separators, 1 234,50, and its side for the symbol, 1 234,50 € in French, unless symbol_before or symbol_after fixes it.

Implementations§

Source§

impl Currency

Source

pub const USD: Self

US dollars, $1,234.50.

Source

pub const EUR: Self

Euros, €1,234.50.

Source

pub const GBP: Self

Pounds sterling, £1,234.50.

Source

pub const JPY: Self

Yen, ¥1,235: no minor unit.

Source

pub const fn new(symbol: &'static str) -> Self

A currency spelled with symbol before the amount and two decimals.

Source

pub const fn decimals(self, decimals: u8) -> Self

Spell decimals digits after the point.

Source

pub const fn symbol_after(self) -> Self

Put the symbol after the amount, separated by a space, in every locale.

Source

pub const fn symbol_before(self) -> Self

Put the symbol before the amount in every locale, as English does.

Source

pub const fn minor_units(self) -> Self

Read the field as minor units, cents for a two-decimal currency: 123456 is 1,234.56.

Source

pub fn format(&self, value: impl Numeric) -> String

Spell value as an amount of this currency in English, or an empty string when it holds none.

Source

pub fn format_in(&self, cx: &Cx, value: impl Numeric) -> String

Spell value as an amount of this currency in the request’s locale, or an empty string when it holds none.

Trait Implementations§

Source§

impl Clone for Currency

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for Currency

Source§

impl Debug for Currency

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for Currency

Source§

impl PartialEq for Currency

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Currency

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AnyEq for T
where T: Any + PartialEq,

Source§

fn equals(&self, other: &(dyn Any + 'static)) -> bool

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more