Regex:Replace

Busca na string informada no primeiro parâmetro a quantidade\(terceiro parâmetro\) de ocorrências do padrão, trocando pelo valor informado no terceiro parâmetro.

Sintaxe

Replace( < @cText >, < cNewText >, [ nCount ], [ lReverse ] )

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
cText	String	Texto em que o padrão será procurado. O retorno ocorre nesse parâmetro, por referência.	X	X
cNewText	String	TTexto pelo qual o padrao encontrado será substituido	X
nCount	Inteiro	Numero de trocas a serem efetuadas. Caso esse valor nao seja passado, apenas a primeira ocorrência é trocada.
lReverse	Lógico	Ordem de busca no texto. Esse parâmetro é opcional, o padrão é false. Se for informado true, a busca ocorre do final para o inicio \(direita->esquerda\)

Retorno

Nome	Tipo	Descrição	Observações
lRet	Lógico	Indica se o método foi executado com sucesso	O novo texto, é retornado no parâmetro cText.

Observações

* Se nCount não for informado, troca apenas a primeira ocorrência. A busca é realizada da esquerda para direita, caso necessite que seja invertido usar quarto parâmetro.

Exemplos

Exemplo Construtor

namespace tlpp.regex

Function u_regexReplace()
    Local meuTexto := "0Vou 1trocar 23os 4num5eros 6."
    Local MyRegex := Regex():New('^.d')
    MyRegex:replace(@meuTexto, "A", 2)
    MyRegex:replace(@meuTexto, "Z")
    conout(meuTexto)  // "AVou Atrocar Zos ZnumZeros Z."
Return

Veja também

ReplaceAll

Árvore de páginas