Á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()
  Local cString 
:= "
Texto
To 
para
compute, 
StrTran
or 
Texto
not 
para StrTran Texto para StrTran"  cSearch := "StrTran" cReplace := "***Substitui***" nStart := 1 // Compatibilidade nCount := 2 // Substitui as duas primeiras strings cString2 := StrTran(cString, cSearch, cReplace, nStart, nCount)   MsgAlert(cString + chr(13) + cString2)
Informações
titleAbrangência
  • Advanced Protheus 6.09
  • Advanced Protheus 7.10
  • Microsiga Protheus 8.11
  • Protheus 10

 

 
 
to compute?"
  conout( StrTran( cString, "compute", "be" ) ) // To be, or not to be?
return