Return only those currencies meeting the filter criteria.

Arguments

• currency is a Cldr.Currency.t, a list of Cldr.Currency.t or a map where the values of each item is a Cldr.Currency.t

• only is :all, :current, :historic, :tender unannotated or a list of one or more status or currency codes. The default is :all

• except is :current, :historic, :tender unannotated or a list of one or more status or currency codes. The default is nil

Currency Status

A currency may be in current use, of historic interest only. It may or may not be legal tender. And it may mostly be used as a financial instrument. To help return the most useful currencies the currency status code acts as follows:

• :all, the default, returns all currencies

• :current returns those currencies that have a :to date of nil and which also is a known ISO4217 currency

• :historic is the opposite of :current

• :tender is a currency that is legal tender

• :unannotated is a currency that doesn't have "(some string)" in its name. These are usually financial instruments.