CKTIS / Python
Substituir correspondências de uma expressão regular compilada com re.Pattern.sub
Chama `sub()` numa expressão regular compilada para substituir correspondências por um modelo ou pelo resultado de uma função. Usa `count` para limitar o número de substituições.
Versão: Python 3.12
Sintaxe
pattern = re.compile(regex, flags=0)
pattern.sub(repl, string, count=0)Em Python 3.12, re.Pattern.sub é um método do objeto devolvido por re.compile(). Chama-o como pattern.sub(repl, string, count=0). Ao contrário da função de módulo re.sub(), o método não recebe um padrão em separado nem um argumento flags: usa o padrão e as opções guardados no objeto. Podes reutilizar o mesmo objeto com entradas diferentes.
O método substitui, da esquerda para a direita, as correspondências que não se sobrepõem e devolve o resultado sem alterar a entrada. Se não houver correspondências, devolve a entrada inalterada. Um count positivo define o número máximo de substituições; 0 ou a omissão do argumento significa que não há limite. Uma correspondência vazia é ignorada se vier imediatamente após outra correspondência vazia, mas pode ser substituída logo após uma correspondência não vazia.
Se repl for uma cadeia de caracteres, é interpretada como modelo: \g<id> insere o texto capturado pelo grupo com o nome id e \g<0> insere a correspondência inteira. Nem a notação r"..." desativa a interpretação do modelo. Por exemplo, \n insere uma mudança de linha e uma sequência de escape desconhecida composta por uma barra invertida e uma letra ASCII provoca um erro.
Se repl for uma função, o método chama-a uma vez por cada correspondência a substituir e passa-lhe um objeto re.Match. O valor devolvido é inserido literalmente, sem ser interpretado como modelo. Usa esta forma para inserir texto arbitrário literalmente, em vez de usar re.escape(), que se destina a padrões. Não mistures str e bytes entre o padrão, a entrada e o valor de substituição, mesmo quando este é devolvido pela função.
Exemplos
import re
pattern = re.compile(r"sku=(?P<id>[0-9]+)", re.IGNORECASE)
text = "sku=7, SKU=42"
def format_item(match):
return f"item-{int(match.group('id')):04d}"
print(pattern.sub(r"item-\g<id>", text, count=1))
print(pattern.sub(format_item, text))Resultado
item-7, SKU=42 item-0007, item-0042
As duas chamadas reutilizam o mesmo padrão com `re.IGNORECASE`. O modelo com `count=1` altera apenas `sku=7`. A segunda chamada volta a partir do texto original e acrescenta zeros à esquerda até ambos os identificadores terem quatro algarismos.
Lições relacionadas
- Python · Lição 34 · Avançado · Versão: 5