str.format() Formatar string
Última atualização: 2026-09-22
str.format() Formatar string
str.format(*args, **kwargs) substitui os marcadores de posição {} por args/kwargs.
| Categoria | Métodos de string |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
str.format(...)⚙️ Parâmetros
| args Opcional | Variable positional args mapped to {} or {0} placeholders. |
|---|---|
| kwargs Opcional | Variable keyword args mapped to {name} placeholders. |
Retorno：str. A new string with placeholders replaced by args/kwargs.
Modifica o original：Não (retorna um novo objeto)
💥 Exceções
IndexError— Raised when a positional placeholder index is out of range.KeyError— Raised when a placeholder field name is missing from kwargs.ValueError— Raised for an invalid format specifier or field reference syntax.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
Hello, World!
Alice is 30💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QQuais são as diferentes formas de escrever os marcadores {}?
ATrês: {} corresponde automaticamente por posição, {0}/{1} por índice e {name} por palavra-chave. Por exemplo, '{0}-{name}'.format(1, name='x') resulta em '1-x'.
QQue erros são lançados quando marcadores e argumentos não coincidem?
AUm índice que ultrapassa o número de argumentos em um marcador posicional lança IndexError; a ausência da palavra-chave para {name} lança KeyError; um especificador de formato inválido lança ValueError.
QComo exibo um {} literal?
AEscape-o com chaves duplicadas: '{{}}'.format() produz '{}'.
QDevo usar isso ou f-strings?
APrefira f-strings (Python 3.6+) na maioria dos casos, porque são mais legíveis. format() é adequado para templates armazenados em variáveis, onde a string de formato precisa ser construída dinamicamente.
