str.replace() Substitui substrings
Última atualização: 2026-09-22
str.replace() Substitui substrings
str.replace(old, new[, count]) retorna uma cópia com old substituído por new; count limita o número de vezes.
| Categoria | Métodos de string |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
str.replace(old, new[, count])⚙️ Parâmetros
| old Obrigatório | The substring to be replaced. |
|---|---|
| new Obrigatório | The replacement substring. |
| count Opcional | Maximum number of replacements; -1 means replace all.（Padrão：-1） |
Retorno：str. A copy with old replaced by new, up to count times.
Modifica o original：Não (retorna um novo objeto)
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
bbb
bbaa💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO replace() modifica a string original?
ANão! Strings são imutáveis; o replace() retorna uma nova string. 'aaa'.replace('a', 'b') gera uma nova string enquanto a variável original permanece inalterada; você precisa atribuir o resultado para capturá-lo.
QComo substituir apenas as primeiras ocorrências?
AUse o parâmetro count: 'aaa'.replace('a', 'b', 2) substitui apenas as 2 primeiras, resultando em 'bba'.
QO que acontece quando o substring a ser substituído não existe?
ANenhum erro; uma cópia da string original é retornada diretamente.
QComo faço para excluir um substring?
ASubstitua por uma string vazia: 'a-b-c'.replace('-', '') resulta em 'abc'.
