4D v14.3Replace string |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
Replace string
|
Replace string ( fonte ; obsoleto ; novo {; quantasVezes}{; *} ) -> Resultado | ||||||||
Parâmetro | Tipo | Descrição | ||||||
fonte | cadeia |
![]() |
Cadeia original | |||||
obsoleto | cadeia |
![]() |
Caracteres a substituir | |||||
novo | cadeia |
![]() |
Cadeia que vai substituir a velha (se estiver vazia, as ocorrências são apagadas) | |||||
quantasVezes | Inteiro longo |
![]() |
Quantas vezes substituir; se omitido, todas as ocorrências serão substituídas | |||||
* | Operador |
![]() |
Se passado: avaliação baseada em códigos de caracteres | |||||
Resultado | cadeia |
![]() |
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 *:
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"
Produto: 4D
Tema: String
Número
233
Modificado: 4D v11 SQL Release 1
Change string
Delete string
Insert string
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)