Skip to contents

Get Brazilian state capital names

Source: R/brazil_state_capital.R
brazil_state_capital.Rd

brazil_state_capital() returns a vector with the capital names of Brazilian states or federal units.

Usage

brazil_state_capital(x = NULL)

Arguments

x

(optional) An atomic vector containing the names of Brazilian states or federal units. Municipality and state codes are also supported. If NULL, returns a vector with all state capital names (default: NULL).

Value

A character vector with the names of Brazilian state capitals.

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_fu(), 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_code(), brazil_state_latitude(), brazil_state_longitude()

Examples

brazil_state_capital()
#>                Acre             Alagoas               Amapá 
#>        "Rio Branco"            "Maceió"            "Macapá" 
#>            Amazonas               Bahia               Ceará 
#>            "Manaus"          "Salvador"         "Fortaleza" 
#>    Distrito Federal      Espírito Santo               Goiás 
#>          "Brasília"           "Vitória"           "Goiânia" 
#>            Maranhão         Mato Grosso  Mato Grosso do Sul 
#>          "São Luís"            "Cuiabá"      "Campo Grande" 
#>        Minas Gerais                Pará             Paraíba 
#>    "Belo Horizonte"             "Belém"       "João Pessoa" 
#>              Paraná          Pernambuco               Piauí 
#>          "Curitiba"            "Recife"          "Teresina" 
#>      Rio de Janeiro Rio Grande do Norte   Rio Grande do Sul 
#>    "Rio de Janeiro"             "Natal"      "Porto Alegre" 
#>            Rondônia             Roraima      Santa Catarina 
#>       "Porto Velho"         "Boa Vista"     "Florianópolis" 
#>           São Paulo             Sergipe           Tocantins 
#>         "São Paulo"           "Aracaju"            "Palmas" 

brazil_state_capital("pi")
#> [1] "Teresina"
#> [1] "Teresina" # Expected

brazil_state_capital("piaui")
#> [1] "Teresina"
#> [1] "Teresina" # Expected

brazil_state_capital(22)
#> [1] "Teresina"
#> [1] "Teresina" # Expected

brazil_state_capital(2211001) # Teresina
#> [1] "Teresina"
#> [1] "Teresina" # Expected

brazil_state_capital(22110011) # >7 digits
#> [1] NA
#> [1] NA # Expected

brazil_state_capital(3912345) # Non-existent state code
#> [1] NA
#> [1] NA # Expected