4D v16.3

Replace string

Página Inicial

 
4D v16.3
Replace string

Replace string 


 

Replace string ( fonte ; obsoleto ; novo {; quantasVezes}{; *} ) -> Resultado 
Parâmetro Tipo   Descrição
fonte  String in Cadeia original
obsoleto  String in Caracteres a substituir
novo  String in Cadeia que vai substituir a velha (se estiver vazia, as ocorrências são apagadas)
quantasVezes  Inteiro longo in Quantas vezes substituir; se omitido, todas as ocorrências serão substituídas
Operador in Se passado: avaliação baseada em códigos de caracteres
Resultado  String in Cadeia resultante

Replace string substitui um número quantasVezes de ocorrências, em fonte, de obsoleto por novo .

Se novo for uma cadeia vazia (""), Replace string apaga cada ocorrência de obsoleto em fonte.

Se quantasVezes for especificada, Replace string apenas substituirá o número de ocorrências de obsoleto especificadas, a partir do primeiro caractere de fonte. Se quantasVezes não for especificada, então todas as ocorrências de obsoleto serão substituídas.

Se obsoleto for uma cadeia vazia,Replace string devolve fonte intacto.

Como padrão, o comando faz comparações globais que consideram  particularidades linguísticas e das letras que podem ser escritas com um ou mais caracteres (por exemplo æ = ae). Por outro lado, se não for diacrítico (a=A, a=à, etc.) e não considerar os caracteres "ignoráveis" tais como os caracteres cujo código for < 9 (especificação Unicode).

Para modificar este funcionamento, passe como último parâmetro *. Neste caso, as comparações estarão baseadas em códigos de caracteres.

Deve passar o parâmetro *:

  • Se deseja substituir os caracteres especiais, utilizados por exemplo como delimitadores (Char(1)...),
  • Se o substituto de caracteres deve considerar as maiúsculas, minúsculas e os caracteres acentuados (a#A, a#à, etc.).
  • Note que nesse modo, a avaliação não lida com  variações na maneira como as palavras são escritas.

Nota: Em 4D v15 R3 e superior, uma otimização significativa foi feita ao algoritmo usado pelo comando quando substituir uma string por outra de um tamanho diferente, independente da sintaxe usada. Isto resulta em uma considerável aceleração do processamento.

O exemplo abaixo ilustra o uso de Replace string. Os resultados, descritos nos comentários, são atribuídos a variável vtResult.

 vtResult:=Replace string("Filho";"lh";"tr") ` vtResult é igual a "Filtro"
 vtResult:=Replace string(General"; "ne";"")  ` vtResultes igual a "Geral"
 vtResult:=Replace string(vtOutraVar;Char(Tab);",";*) ` Substitui todas as tabulações em vtOutraVar por vírgulas

O exemplo abaixo elimina os retornos de carro e as tabulações do texto na variável vtResult:

 vtResult:=Replace string(Replace string(vtResult;Char(Carriage return);"";*);Char(Tab);"")

O exemplo abaixo ilustra o  uso do parâmetro * no caso de uma avaliação diacrítica:

 vtResult:=Replace string("Crème brûlée";"Brulee";"caramel") `vtResult é igual a "Crème caramel"
 vtResult:=Replace string("Crème brûlée";"Brulee";"caramel";*) `vtResult é igual a "Crème brûlée"



Ver também 

Change string
Delete string
Insert string

 
PROPRIEDADES 

Produto: 4D
Tema: String
Número 233

This command can be run in preemptive processesO modo Unicode afeta este comando

 
HISTÓRIA 

Modificado: 4D v11 SQL Release 1
Modificado: 4D v15 R3

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)