currencies v0.5.1 Currencies
Specialized functions that return Currencies.
Summary
Functions
Returns all currencies
Returns all currencies whose currency codes or integer iso numeric code matches the items in the list Returns :not_found if the a currency with the given currency code or iso numeric code can not be found
Returns the central_bank associated with the given currency code or iso numeric code Returns :not_found if the a currency with the given currency code can not be found. Returns :not_found if the a central_bank for the currency with the given currency code can not be found
Returns all currencies matching the given predicate
Returns a single currency given given its currency code or iso numeric code Returns :not_found if the a currency with the given currency code can not be found
Returns the minor_unit associated with the given currency code or iso numeric code Returns :not_found if the a currency with the given currency code can not be found. Returns :not_found if the a minor_unit for the currency with the given currency code can not be found
Functions
Returns all currencies whose currency codes or integer iso numeric code matches the items in the list Returns :not_found if the a currency with the given currency code or iso numeric code can not be found.
Examples
iex> Currencies.all(["aud", :sgd, 51, %{}])
[%Currencies.Currency{alternate_symbols: ["A$"],
central_bank: %Currencies.CentralBank{name: "Reserve Bank of Australia",
url: "http://www.rba.gov.au"}, code: "AUD", disambiguate_symbol: "A$",
iso_numeric: "036",
minor_unit: %Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "c"}, name: "Australia Dollar",
nicknames: ["Buck", "Dough"],
representations: %Currencies.Representations{html: "$",
unicode_decimal: '$'}, symbol: "$",
users: ["Australia", "Christmas Island", "Cocos (Keeling) Islands",
"Kiribati", "Nauru", "Norfolk Island", "Ashmore and Cartier Islands",
"Australian Antarctic Territory", "Coral Sea Islands", "Heard Island",
"McDonald Islands"]},
%Currencies.Currency{alternate_symbols: ["S$"],
central_bank: %Currencies.CentralBank{name: "Monetary Authority of Singapore",
url: "http://www.mas.gov.sg"}, code: "SGD", disambiguate_symbol: "S$",
iso_numeric: "702",
minor_unit: %Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "S¢"}, name: "Singapore Dollar",
nicknames: ["Sing"],
representations: %Currencies.Representations{html: "$",
unicode_decimal: '$'}, symbol: "$", users: ["Singapore"]},
%Currencies.Currency{alternate_symbols: ["dram"],
central_bank: %Currencies.CentralBank{name: "Central Bank of Armenia",
url: "http://www.cba.am"}, code: "AMD", disambiguate_symbol: nil,
iso_numeric: "051",
minor_unit: %Currencies.MinorUnit{display: "1/100", name: "Luma",
size_to_unit: 100, symbol: nil}, name: "Armenia Dram", nicknames: nil,
representations: %Currencies.Representations{html: nil, unicode_decimal: nil},
symbol: nil, users: ["Armenia"]}, :not_found]
Returns the central_bank associated with the given currency code or iso numeric code Returns :not_found if the a currency with the given currency code can not be found. Returns :not_found if the a central_bank for the currency with the given currency code can not be found.
Get central_bank given its currency code as a symbol
iex> Currencies.central_bank(:aud)
%Currencies.CentralBank{name: "Reserve Bank of Australia",
url: "http://www.rba.gov.au"}
Get central_bank given its currency code as a string/binary
iex> Currencies.central_bank("AUD")
%Currencies.CentralBank{name: "Reserve Bank of Australia",
url: "http://www.rba.gov.au"}
Get central_bank given its iso numeric code as an integer
iex> Currencies.central_bank(36)
%Currencies.CentralBank{name: "Reserve Bank of Australia",
url: "http://www.rba.gov.au"}
Try to get a central_bank using an unsupported type
iex> Currencies.central_bank(%{})
:not_found
Try to get a central_bank using an invalid currency code
iex> Currencies.central_bank("OMG")
:not_found
Try to get a central_bank using a currency code which does not have a central_bank
iex> Currencies.central_bank("FJD")
:not_found
Returns all currencies matching the given predicate
Examples
iex> Currencies.filter(&(String.contains?(&1.name, "Peso")))
...> |> Enum.map(&(&1.name))
["Argentina Peso",
"Chile Peso",
"Colombia Peso",
"Cuba Convertible Peso",
"Cuba Peso",
"Dominican Republic Peso",
"Mexico Peso",
"Philippines Peso",
"Uruguay Peso"]
Returns a single currency given given its currency code or iso numeric code Returns :not_found if the a currency with the given currency code can not be found.
Get currency given its currency code as a symbol
iex> Currencies.get(:aud)
%Currencies.Currency{alternate_symbols: ["A$"],
central_bank: %Currencies.CentralBank{name: "Reserve Bank of Australia",
url: "http://www.rba.gov.au"}, code: "AUD",
disambiguate_symbol: "A$", iso_numeric: "036",
minor_unit: %Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "c"}, name: "Australia Dollar",
nicknames: ["Buck", "Dough"],
representations: %Currencies.Representations{html: "$",
unicode_decimal: [36]}, symbol: "$",
users: ["Australia", "Christmas Island", "Cocos (Keeling) Islands",
"Kiribati", "Nauru", "Norfolk Island",
"Ashmore and Cartier Islands", "Australian Antarctic Territory",
"Coral Sea Islands", "Heard Island", "McDonald Islands"]}
Get currency given its currency code as a string/binary
iex> Currencies.get("AUD")
%Currencies.Currency{alternate_symbols: ["A$"],
central_bank: %Currencies.CentralBank{name: "Reserve Bank of Australia",
url: "http://www.rba.gov.au"}, code: "AUD",
disambiguate_symbol: "A$", iso_numeric: "036",
minor_unit: %Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "c"}, name: "Australia Dollar",
nicknames: ["Buck", "Dough"],
representations: %Currencies.Representations{html: "$",
unicode_decimal: '$'}, symbol: "$",
users: ["Australia", "Christmas Island", "Cocos (Keeling) Islands",
"Kiribati", "Nauru", "Norfolk Island",
"Ashmore and Cartier Islands", "Australian Antarctic Territory",
"Coral Sea Islands", "Heard Island", "McDonald Islands"]}
Get currency given its iso numeric code as an integer
iex> Currencies.get(36)
%Currencies.Currency{alternate_symbols: ["A$"],
central_bank: %Currencies.CentralBank{name: "Reserve Bank of Australia",
url: "http://www.rba.gov.au"}, code: "AUD",
disambiguate_symbol: "A$", iso_numeric: "036",
minor_unit: %Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "c"}, name: "Australia Dollar",
nicknames: ["Buck", "Dough"],
representations: %Currencies.Representations{html: "$",
unicode_decimal: '$'}, symbol: "$",
users: ["Australia", "Christmas Island", "Cocos (Keeling) Islands",
"Kiribati", "Nauru", "Norfolk Island",
"Ashmore and Cartier Islands", "Australian Antarctic Territory",
"Coral Sea Islands", "Heard Island", "McDonald Islands"]}
Try to get a currency using an unsupported type
iex> Currencies.get(%{})
:not_found
Returns the minor_unit associated with the given currency code or iso numeric code Returns :not_found if the a currency with the given currency code can not be found. Returns :not_found if the a minor_unit for the currency with the given currency code can not be found.
Get minor_unit given its currency code as a symbol
iex> Currencies.minor_unit(:aud)
%Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "c"}
Get minor_unit given its currency code as a string/binary
iex> Currencies.minor_unit("AUD")
%Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "c"}
Get minor_unit given its iso numeric code as an integer
iex> Currencies.minor_unit(36)
%Currencies.MinorUnit{display: "1/100", name: "Cent",
size_to_unit: 100, symbol: "c"}
Try to get a minor_unit using an unsupported type
iex> Currencies.minor_unit(%{})
:not_found
Try to get a minor_unit using an invalid currency code
iex> Currencies.minor_unit("OMG")
:not_found
Try to get a minor_unit using a currency code which does not have a minor_unit
iex> Currencies.minor_unit("VUV")
:not_found