Monetized v0.3.1 Monetized.Currency

Defines available currencies and functions to handle them.

Summary

Functions

all()

Retrieves a struct holding all the currency options

get(key)

Retrieves the currency struct for the given key

keys()

Retrieves a list of currency options keys

parse(str)

Attempts to parse the currency from the given string based on both the currency key and the symbol

parse_by_key(str)

Attempts to parse the currency from the given string based on the currency key

parse_by_symbol(str)

Attempts to guess the currency from the given string based on the currency symbol

Functions

all()

Specs

all :: struct

Retrieves a struct holding all the currency options.

get(key)

Specs

get(String.t) :: struct

Retrieves the currency struct for the given key.

Examples

iex> Monetized.Currency.get("EUR")
%{name: "Euro", symbol: "€", key: "EUR"}

keys()

Specs

keys :: list

Retrieves a list of currency options keys

parse(str)

Attempts to parse the currency from the given string based on both the currency key and the symbol.

Examples

iex> Monetized.Currency.parse("EUR 200.00")
%{name: "Euro", symbol: "€", key: "EUR"}

iex> Monetized.Currency.parse("£ 200.00")
%{name: "Pound Sterling", symbol: "£", key: "GBP"}

iex> Monetized.Currency.parse("200.00 $")
%{name: "US Dollar", symbol: "$", key: "USD"}

parse_by_key(str)

Attempts to parse the currency from the given string based on the currency key.

Examples

iex> Monetized.Currency.parse_by_key("EUR 200.00")
%{name: "Euro", symbol: "€", key: "EUR"}

iex> Monetized.Currency.parse_by_key("200.00 USD")
%{name: "US Dollar", symbol: "$", key: "USD"}

iex> Monetized.Currency.parse_by_key("200.00 GBP")
%{name: "Pound Sterling", symbol: "£", key: "GBP"}

parse_by_symbol(str)

Attempts to guess the currency from the given string based on the currency symbol.

Examples

iex> Monetized.Currency.parse_by_symbol("€ 200.00")
%{name: "Euro", symbol: "€", key: "EUR"}

iex> Monetized.Currency.parse_by_symbol("200.00 $")
%{name: "US Dollar", symbol: "$", key: "USD"}

iex> Monetized.Currency.parse_by_symbol("£200.00")
%{name: "Pound Sterling", symbol: "£", key: "GBP"}