Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
portuguese
Composition Setup
import.css=/download/attachments/3279126062824/newLayouttecnologia.css

Pagetitle
StrTran
StrTran

Função: StrTran

Pesquisa e substitui um conjunto de caracteres de uma string

...

.

Sintaxe

Bloco de código
collapsefalse
StrTran( <
cString>
 cString >, <
cSearch>
 cSearch >, [ cReplace ], [ nStart ], [ nCount ] )
--> cRet

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

Bloco de código
themeEclipse
languagecpp
titleExemplo 1
linenumberstrue
collapsefalse
function u_exemplo1
User Function TSTTran
()
cString
  
:= "Texto para teste para substituição para busca e troca"  cSearch
Local cString := "
para" cReplace := "de" nStart := 2 // A partir de qual ocorrencia inicia a substituição nCount := 2 // Substitui apenas duas ocorrencias cString2 := StrTran(cString, cSearch, cReplace, nStart, nCount)   MsgAlert(cString + chr(13) + cString2
To compute, or not to compute?"
  conout( StrTran( cString, "compute", "be" ) ) // 
"Texto para teste de substituição de busca e troca"   // Nas builds anteriores a 7.00.131227A, a função não respeitava o 4o parametro,  // e a função substituía a partir da primeira ocorrência, ficando o texto final como // "Texto de teste de substituição para busca e troca"
Informações
titleAbrangência
  • Advanced Protheus 6.09
  • Advanced Protheus 7.10
  • Microsiga Protheus 8.11
  • Protheus 10

 

 
 
To be, or not to be?
return