TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user Rogerio Ribeiro da Cruz

Gravado em

comparado com

Nova versão 3

changes.mady.by.user Julio Wittwer

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Nota de release de comportamento da StrTran() a partir da Build 7.00.131227A

...

Portuguese

Pagetitle
StrTran
StrTran

Função: StrTran

Pesquisa e substitui caracteres de uma string ou campo memo.

Sintaxe

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

Parâmetros/Elementos

 

NomeTipoDescriçãoObrigatórioReferência
cStringCaracterIndica a sequência de caracteres ou campo memo que será pesquisada.X 
cSearchCaracterIndica a sequência de caracteres que será procurada na string (cString).X 
cReplaceCaracterIndica a sequência de caracteres que deve substituir a string cSearch. Caso não seja especificado, as ocorrências de cSearch em cString serão substituídas por uma string vazia ("").  
nStartNumérico(**) Indica o número sequencial da primeira ocorrência, de cSearch em cString, a partir de qual ocorrência da expressão cSearch encontrada dentro de cString que será substituída por cReplace. Caso não seja especificado, o valor padrão default será 1 (um). No entanto, se for especificado Caso seja especificado erroneamente um número menor que 1 (um), a função retornará uma string vazia ("").  
nCountNuméricoIndica o número máximo de trocas que deve ser realizada pela função. Caso não seja especificado, o padrão é substituir todas as ocorrências encontradas.  

 

Retorno
cRet
    (caracter)
  • Retorna uma nova string, onde as ocorrências especificadas de cSearch encontradas em cString foram substituídas por cReplace.
Observações
  • Essa função é case sensitive; ou seja, faz diferença entre letras maiúsculas é minúsculas.
  • (**) 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 ). , até a Build 7.00.121227 era ignorado quando especificado, sendo sempre considerado o valor default (1), sinalizando para a função que a troca das strings era feita sempre a partir da primeira ocorrência encontrada. A partir da build 7.00.131227A, o valor informado no 4º parâmetro passou a ser considerado corretamente.

 

Bloco de código
themeEclipse
languagecpp
titleExemplo
linenumberstrue
User Function TSTTran()
cString  := "Texto para StrTranteste para Textosubstituição para StrTranbusca Textoe para StrTrantroca" 
cSearch  := "StrTranpara"
cReplace := "***Substitui***de"
nStart   := 12 // Compatibilidade A partir de qual ocorrencia inicia a substituição 
nCount   := 2 // Substitui asapenas duas primeirasocorrencias strings
cString2 := StrTran(cString, cSearch, cReplace, nStart, nCount)
 
MsgAlert(cString + chr(13) + cString2) // "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