str.format_map() Formatar com objeto de mapeamento
Última atualização: 2026-09-22
str.format_map() Formatar com objeto de mapeamento
str.format_map(mapping) formata a string usando um objeto mapping (em vez de **kwargs).
| Categoria | Métodos de string |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
str.format_map(mapping)⚙️ Parâmetros
| mapping Obrigatório | A mapping object supplying field values, like **kwargs. |
|---|
Retorno：str. A new string with placeholders filled from the mapping.
Modifica o original：Não (retorna um novo objeto)
💥 Exceções
KeyError— Raised when a placeholder field name is missing from the mapping.ValueError— Raised for an invalid format specifier.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
Alice is 30💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QQual é a diferença entre format_map() e format(**dict)?
Aformat_map() recebe o objeto de mapeamento diretamente, sem expandi-lo em argumentos de palavra-chave. Combinado com uma subclasse de dict (como uma que implemente __missing__, como defaultdict), pode fornecer valores padrão quando uma chave estiver ausente.
QO que acontece quando uma chave não existe?
AÉ lançado um KeyError. Você pode retornar um valor padrão implementando __missing__ em uma subclasse personalizada de dict.
QO que acontece quando um objeto que não é um mapeamento é passado?
AUma exceção é lançada (TypeError ou AttributeError quando o objeto não suporta a consulta). O argumento deve fornecer capacidade de consulta por valor de campo.
