TOTVSTEC

Árvore de páginas

Pesquisa e substitui um conjunto de caracteres de uma string.

Sintaxe

StrTran( < cString >, < cSearch >, [ cReplace ], [ nStart ], [ nCount ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cString

caractere

Indica a sequência de caracteres ou campo memo onde será realizado a pesquisa.

X

 

cSearch

caractere

Indica a sequência de caracteres que será pesquisada.

X

 

cReplace

caractere

Indica a sequência de caracteres que deve substituir a expressão localizada.

 

 

nStart

numérico

Indica a primeira ocorrência a ser substituída.

 

 

nCount

numérico

Indica o número de substituições que devem ser realizadas.

 

 

Retorno

Nome

Tipo

Descrição

cRet

caractere

Retorna uma nova string com as ocorrências de cSearch substituídas por cReplace.

Observações

  • Essa função é case sensitive, ou seja, diferencia letras maiúsculas e minúsculas.
  • Quando cReplace não é informado, as ocorrências são substituídas por uma string vazia ("").
  • Quando nStart não é informado, é assumido o valor padrão 1.
  • Quando nCount não é informado, todas as ocorrências são substituídas.
  • Em builds anteriores a 7.00.131227A, nStart sempre assume o valor padrão (1).
  • A partir da build 7.00.131227A, nStart indica a primeira ocorrência a ser substituída.

Exemplos

Exemplo 1
function u_exemplo1()
  Local cString := "To compute, or not to compute?"
  conout( StrTran( cString, "compute", "be" ) ) // To be, or not to be?
return
  • Sem rótulos