Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 4 Atual »

Pesquisa e substitui um conjunto de caracteres de uma string.

Sintaxe

cNewString := strTran(<cString>, <cSearch>, [<cReplace>], [<nStart>], [<nCount>])

Parâmetros

NomeTipoDescriçãoObrigatório
cStringCaractereIndica a sequência de caracteres ou campo memo onde será realizado a pesquisa.X
cSearchCaractereIndica a sequência de caracteres que será pesquisada.X
cReplaceCaractereIndica a sequência de caracteres que deve substituir a expressão localizada. Quando não informado, as ocorrências são substituídas por uma string vazia (""). 
nStartNumérico

Indica a primeira ocorrência a ser substituída. Quando não informado, é assumido o valor 1.

(aviso) Em builds anteriores a 7.00.131227A, o 4º parâmetro sempre assume o valor padrão (1).

 
nCountNuméricoIndica o número de substituições que devem ser realizadas. Quando não informado, todas as ocorrências são substituídas. 

Retorno

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

Observações

  1. Essa função é case sensitive; ou seja, diferencia letras maiúsculas e minúsculas.
  2. (aviso) Em builds anteriores a 7.00.131227A, o 4º parâmetro (<nStart>) sempre assume o valor padrão (1).
  3. (aviso) A partir da build 7.00.131227A, o 4º parâmetro (<nStart>) indica a primeira ocorrência a ser substituída.

Exemplo

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