Get Brazilian federative unit abbreviations

brazil_fu() returns a vector with the abbreviations of Brazilian federal units.

Usage

brazil_fu(x = NULL)

Arguments

x

(optional) An atomic vector containing the names or numeric codes of Brazilian regions or federal units. Municipality codes are also supported. If NULL, returns a character vector with all Brazilian federal unit abbreviations (default: NULL).

Value

A character vector with the abbreviations of Brazilian federal units.

Details

The data from this function is based on data from the Brazilian Institute of Geography and Statistics (IBGE, n.d.).

References

Instituto Brasileiro de Geografia e Estatística. (n.d.). Território [Territory] [Dataset]. SIDRA. https://sidra.ibge.gov.br/territorio

See also

Other Brazil functions: brazil_municipality(), brazil_municipality_code(), brazil_municipality_coords(), brazil_municipality_latitude(), brazil_municipality_longitude(), brazil_region(), brazil_region_code(), brazil_render_address(), brazil_state(), brazil_state_by_utc(), brazil_state_capital(), brazil_state_code(), brazil_state_latitude(), brazil_state_longitude()

Examples

brazil_fu()
#>  [1] "AC" "AL" "AP" "AM" "BA" "CE" "DF" "ES" "GO" "MA" "MT" "MS" "MG" "PA"
#> [15] "PB" "PR" "PE" "PI" "RJ" "RN" "RS" "RO" "RR" "SC" "SP" "SE" "TO"

brazil_fu("sp")
#> [1] "SP"
#> [1] "SP" # Expected

brazil_fu("sao paulo")
#> [1] "SP"
#> [1] "SP" # Expected

brazil_fu(35)
#> [1] "SP"
#> [1] "SP" # Expected

brazil_fu(3550308) # Municipality of São Paulo
#> [1] "SP"
#> [1] "SP" # Expected

brazil_fu(35503081) # >7 digits
#> [1] NA
#> [1] NA # Expected

brazil_fu(39027001) # Non-existent state code
#> [1] NA
#> [1] NA # Expected

brazil_fu("southeast")
#> [1] "ES" "MG" "RJ" "SP"
#> [1] "ES" "MG" "RJ" "SP" # Expected

brazil_fu(3)
#> [1] "ES" "MG" "RJ" "SP"
#> [1] "ES" "MG" "RJ" "SP" # Expected