info_currencies: View a table with info on supported currencies

View source: R/info_tables.R

info_currenciesR Documentation

View a table with info on supported currencies


The fmt_currency() function lets us format numeric values as currencies. The table generated by the info_currencies() function provides a quick reference to all the available currencies. The currency identifiers are provided (name, 3-letter currency code, and 3-digit currency code) along with the each currency's exponent value (number of digits of the currency subunits). A formatted example is provided (based on the value of 49.95) to demonstrate the default formatting of each currency.


info_currencies(type = c("code", "symbol"), begins_with = NULL)



Type of currency

⁠singl-kw:[code|symbol]⁠ // default: "code"

The type of currency information provided. Can either be code where currency information corresponding to 3-letter currency codes is provided, or symbol where currency info for common currency names (e.g., dollar, pound, yen, etc.) is returned.


Show currencies beginning with a specific letter

⁠scalar<character>⁠ // default: NULL (optional)

Providing a single letter will filter currencies to only those that begin with that letter in their currency code. The default (NULL) will produce a table with all currencies displayed. This option only constrains the information table where type == "code".


There are 172 currencies, which can lead to a verbose display table. To make this presentation more focused on retrieval, we can provide an initial letter corresponding to the 3-letter currency code to begins_with. This will filter currencies in the info table to just the set beginning with the supplied letter.


An object of class gt_tbl.


Get a table of info on all of the currencies where the three-letter code begins with an "h".

info_currencies(begins_with = "h")
This image of a table was generated from the first code example in the `info_currencies()` help file.

Get a table of info on all of the common currency name/symbols that can be used with fmt_currency().

info_currencies(type = "symbol")
This image of a table was generated from the second code example in the `info_currencies()` help file.

Function ID


Function Introduced

v0.2.0.5 (March 31, 2020)

See Also

Other information functions: info_date_style(), info_flags(), info_google_fonts(), info_icons(), info_locales(), info_paletteer(), info_time_style()

gt documentation built on June 22, 2024, 11:11 a.m.