4D v16.3

Replace string

Inicio

 
4D v16.3
Replace string

Replace string 


 

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

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üísticas 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.

Nota: en 4D v15 R3 y superior, se hizo una optimización significativa al algoritmo utilizado por este comando cuando se reemplaza una cadena por otra de diferente longitud, independientemente de la sintaxis utilizada. Esto da como resultado una aceleración considerable del procesamiento en este contexto.

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

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);"")

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"



Ver también 

Change string
Delete string
Insert string

 
PROPIEDADES 

Producto: 4D
Tema: Cadenas de caracteres
Número 233

This command can be run in preemptive processesEl modo Unicode afecta este comando

 
HISTORIA 

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

 
ARTICLE USAGE

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