Friendly country-code conversion — convert

A discoverable wrapper around countrycode::countrycode() exposing the full set of schemes with first-class shortcuts for the high-value ones: flag emoji, currency, top-level domain, continent/region and research codes (Correlates of War, Polity, Gleditsch-Ward, V-Dem, IMF, FAO, FIPS, GAUL).

Usage

convert_country(
  x,
  to = "iso3c",
  from = "country.name",
  custom_match = wdj_overrides(),
  warn = TRUE
)

Arguments

x: A vector of country names or codes.
to: Destination scheme. A shortcut ("iso3c", "flag", "currency", "tld", "continent", "region", "cown", ...) or any raw countrycode destination.
from: Origin scheme (default "country.name").
custom_match: Optional overrides (default wdj_overrides()).
warn: Whether to warn about unmatched inputs.

Value

A vector of converted codes.

Examples

convert_country(c("Japan", "Brazil"), to = "flag")
#> [1] "🇯🇵" "🇧🇷"
convert_country("Germany", to = "currency")
#> [1] "EUR"
convert_country(c("USA", "France"), to = "continent")
#> [1] "Americas" "Europe"