str.maketrans() Construir tabela de tradução
Última atualização: 2026-09-22
str.maketrans() Construir tabela de tradução
str.maketrans(x[, y[, z]]) retorna uma tabela de tradução para uso com str.translate().
| Categoria | Métodos de string |
|---|---|
| Tipo | Método de tipo interno |
| Versão do Python | all |
📝 Sintaxe
str.maketrans(x[, y[, z]])⚙️ Parâmetros
| x Obrigatório | As a single arg, a char-to-char dict; with y/z, the source string to map. |
|---|---|
| y Opcional | A string of equal length to x, mapping chars one-to-one.（Padrão：None） |
| z Opcional | A string of chars to delete from the result.（Padrão：None） |
Retorno：dict. A translation table usable by str.translate().
Modifica o original：Não (retorna um novo objeto)
💥 Exceções
TypeError— Raised when x is the only argument and is not a dict.ValueError— Raised when x and y have different lengths.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída：
h2ll4 w4rld💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QQuais são as três formas de chamada?
Astr.maketrans(x): x é um dicionário de mapeamento caractere-a-caractere; str.maketrans(x, y): x e y são strings de igual comprimento mapeadas caractere por caractere; str.maketrans(x, y, z): z é o conjunto de caracteres a excluir.
QO que acontece quando x e y têm comprimentos diferentes?
AÉ lançado um ValueError; x e y devem ter o mesmo comprimento.
QComo a tabela de tradução gerada é usada?
APasse-a para str.translate(): tbl = str.maketrans('aeiou', '12345'), depois 'hello'.translate(tbl).
