4D Doc Center : Replace string

4D v13.4

Replace string


Replace string ( fuente ; obsoleta ; nueva {; reemplazos}{; *} ) -> Resultado

Parámetro	Tipo	Descripción
fuente	Cadena	Cadena original
obsoleta	Cadena	Caracteres a reemplazar
nueva	Cadena	Cadena de reemplazo (si la cadena está vacía, se borran todas las ocurrencias)
reemplazos	Entero largo	Número de reemplazos a efectuar Si se omite, se reemplazan todas las ocurrencias
*	Operador	Si se pasa: evaluación basada en los códigos de los caracteres
Resultado	Cadena	Cadena resultante

Descripción

Replace string devuelve una cadena de caracteres resultante de reemplazar obsoleto por nuevo en fuente.

Si nuevo es una cadena vacía (""), Replace string borra cada ocurrencia de obsoleto en fuente.

Si se especifica reemplazos, Replace string sólo reemplazará el número de ocurrencias especificado de obsoleto, a partir del primer carácter de fuente. Si no se especifica reemplazos, se reemplazan todas las ocurrencias de obsoleto.

Si reemplazos es una cadena vacía, Replace string devuelve fuente intacto.

Por defecto, el comando no tiene en cuenta si los caracteres están en mayúsculas o minúsculas o si están o no acentuados (a=A, a=à, etc.). Si pasa un asterisco * como último parámetro, indica que la evaluación de los caracteres debe ser diacrítica, en otras palabras, debe tener en cuenta las mayúsculas, minúsculas y caracteres acentuados (a#A, a#à...).

Por defecto, el comando hace comparaciones globales teniendo en cuenta particularidades lingüisticas y de las letras que pueden escribirse con uno o más caracteres (por ejemplo æ = ae). Por otra parte, no es diacrítico (a=A, a=à, etc.) y no tiene en cuenta los caracteres "ignorables" tales como los caracteres cuyo código es < 9 (especificación Unicode).

Para modificar este funcionamiento, pase como último parámetro *. En este caso, las comparaciones estarán basadas en códigos de caracteres. Debe pasar el parámetro *:

Si quiere reemplazar los caracteres especiales, utilizados por ejemplo como delimitadores (Char(1)...),
Si el reemplazo de caracteres debe tener en cuenta las mayúsculas, minúsculas y los caracteres acentuados (a#A, a#à, etc.).
Note que en este modo, la evaluación no maneja variaciones de escritura de las palabras.

Ejemplo 1

El siguiente ejemplo ilustra el uso de Replace string. Los resultados, descritos en los comentarios, son asignados a la variable vtResult.

 vtResult:=Replace string("Ventanilla";"illa";"d") ` vtResult es igual a "Ventana"

 vtResult:=Replace string("Ventanilla";"ill";"") ` vtResultes igual a "Ventana"

 vtResult:=Replace string(vtOtraVar;Char(Tab);",";*) ` Reemplazar todas las tabulaciones en vtOtraVar por comas

Ejemplo 2

El siguiente ejemplo elimina los retornos de carro y las tabulaciones del texto en la variable vtResult:

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

Ejemplo 3

El siguiente ejemplo ilustra el uso del parámetro * en el caso de una evaluación diacrítica:

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

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