Histórico da Página

Composition Setup
import.css=/download/attachments/3279126062824/newLayouttecnologia.css
Portuguese

Pagetitle

	StrTran
	StrTran

Colapse ALL

Expand ALL

Função: StrTran

Pesquisa

...

e

...

substitui

...

um conjunto de caracteres

...

de

...

uma

...

string

...

.

Sintaxe

Bloco de código

collapse	false

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
...
Retorno
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

theme	Eclipse
language	cpp
title	Exemplo 1
linenumbers	true
collapse	false

function u_exemplo1()
  Local cString

(**) O 4º Parâmetro ( nStart ) foi mantido por compatibilidade, e independente do valor especificado, a função ignora o parâmetro e sempre considera o valor 1 ( default ).

Exemplos

cString

 := "

Texto

To

para

compute,

StrTran

or

Texto

not

para StrTran Texto para StrTran" cSearch := "StrTran"cReplace := "***Substitui***"nStart := 1

to compute?"
  conout( StrTran( cString, "compute", "be" ) ) //

CompatibilidadenCount := 2 // Substitui as duas primeiras stringscString2 := StrTran(cString, cSearch, cReplace, nStart, nCount)MsgAlert(cString + chr(13) + cString2)

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10

To be, or not to be?
return

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Função: StrTran

Sintaxe

Parâmetros

Retorno

Observações

Exemplos

Indica a primeira ocorrência a ser substituída.
nCount	numérico