extrair_codigo_ibge: Extract IBGE codes from DATASUS labels

In datasus: An Interface to Brazilian Public Health Data

Extract IBGE codes from DATASUS labels

Description

Extracts the first territorial code embedded in labels such as '"500270 Campo Grande"' and then validates and converts it with [normalizar_codigo_ibge()].

Usage

extrair_codigo_ibge(
  x,
  nivel = c("municipio", "uf", "regiao"),
  formato = NULL,
  desconhecido = c("erro", "na", "manter")
)

Arguments

x	Character vector containing codes or labeled values.
nivel	Territorial level: '"municipio"', '"uf"' or '"regiao"'.
formato	Output format. Municipalities support '"ibge"' (seven digits) and '"datasus"' (six digits). States and regions additionally support '"sigla"' and '"nome"'.
desconhecido	How to handle unknown values: '"erro"', '"na"' or '"manter"'.

Value

A normalized character vector.

Examples

extrair_codigo_ibge(c("500270 Campo Grande", "500370 Dourados"))

datasus documentation built on Oct. 7, 2026, 1:07 a.m.