Substituições

Substituições são permitidas somente dentro de padrões de substituição.Para uma funcionalidade semelhante em expressões regulares, use um backreference (por exemplo, \1).Para obter detalhes sobre backreferences, consulte Referências Anteriores e Backreference Constructs.

Escapres e substituições de caracterees são as únicas construções especiais reconhecidas em um padrão de substituição.Todas as construções sintáticas descritas nas seções a seguir são permitidas apenas em expressões regulares; elas não são reconhecidas em padrões de substituição.Por exemplo, o padrão de substituição a*${txt}b insere a sequência de caracteres "a*" seguida da subsequência correspondida pelo grupo de captura txt, se houver, seguido pela sequência "b".O caractere * não é reconhecido como um metacaractere em um padrão de substituição.Da mesma forma, padrões $ não são reconhecidos em padrões de correspondência de expressões regulares.Dentro de expressões regulares, $ designa o fim da sequência de caracteres.

A tabela a seguir mostra como definir padrõesde substiuição nomeados e numerados.

Caracterer

Descrição

$$$$number

Substitui a última subsequência correspondente ao número de grupo number (decimal).

${nome}

Substitui a última subsequência correspondida a um grupo (? < name >).

$$

Substitui um único "$" literal.

$&

Substitui uma cópia de toda a correspondência em si.

$`

Substitui todo o texto da sequência de entrada antes da correspondência.

$'

Substitui todo o texto da sequência de entrada após a correspondência.

$+

Substitui o último grupo capturado.

$_

Substitui toda a sequência de caracteres de entrada.

Consulte também

Outros recursos

Elementos de linguagem das expressões regulares