STRTRAN( ) (Función)

Busca en una expresión de caracteres o en un campo memo las apariciones de una segunda expresión de caracteres o campo memo y, luego, reemplaza cada aparición con una tercera expresión de caracteres o campo memo.

STRTRAN(cSearched, cExpressionSought [, cReplacement]
   [, nStartOccurrence] [, nNumberOfOccurrences] [, nFlags])

Valores devueltos

Character

Parámetros

• cSearched
  Especifica la expresión de caracteres en la que hay que buscar. El valor de cSearched puede ser un campo memo.

• cExpressionSought
  Especifica la expresión de caracteres que se busca en cSearched. La búsqueda distingue entre mayúsculas y minúsculas. El valor de cExpressionSought puede ser un campo memo.

• cReplacement
  Especifica la expresión de caracteres que sustituye cada aparición de cSearchFor en cSearched. Si se omite cReplacement, las instancias de cExpressionSought se reemplazarán por una cadena vacía.

• nStartOccurrence
  Especifica la instancia de cExpressionSought que se reemplazará en primer lugar. Por ejemplo, si el valor de nStartOccurrence es 4, se empezará a reemplazar a partir de la cuarta instancia de cExpressionSought en cSearched; las tres primeras instancias de cExpressionSought permanecerán sin cambios. La instancia en la que se empieza a reemplazar será de manera predeterminada la primera instancia de cExpressionSought (si se omite nStartOccurrence).

• nNumberOfOccurrences
  Especifica el número de instancias de cExpressionSought que hay que reemplazar. Si omite nNumberOfOccurrences, se reemplazarán todas las instancias cExpressionSought (empezando por la especificada con nStartOccurrence).

• nFlags
  Especifica si en la búsqueda se distingue entre mayúsculas y minúsculas, de acuerdo con los siguientes valores:

  Valor de nFlag	Descripción
  0 (predeterminado)	La búsqueda distingue mayúsculas y minúsculas y se reemplaza con el texto exacto de cReplacement. Éste es el comportamiento de la versión anterior de Visual FoxPro.
  1	La búsqueda no distingue mayúsculas y minúsculas y se reemplaza con el texto exacto de cReplacement.
  2	La búsqueda distingue mayúsculas y minúsculas y se reemplaza con el texto exacto de cReplacement.
  3	La búsqueda no distingue mayúsculas y minúsculas; se cambian las mayúsculas y minúsculas de cReplacement de forma que coincidan con las de cExpressionSought, la expresión a la que reemplaza.

  También puede especificar el comportamiento predeterminado transfiriendo –1 como el valor de nFlags.

Observaciones

También puede especificar dónde comienza la sustitución y cuántas sustituciones se harán. STRTRAN( ) devuelve la cadena de caracteres resultante. Especifique –1 en los parámetros opcionales que desee omitir si sólo tiene que especificar el valor de nFlags.

Ejemplo

STORE 'abracadabra' TO gcString
? STRTRAN(gcString, 'a', 'z')  && Displays zbrzczdzbrz
? STRTRAN(gcString, 'a', 'q', 2, 3)  && Displays abrqcqdqbra

Vea también

CHRTRAN( ) | CHRTRANC( ) | STUFF( ) | Crear expresiones de tipo Character STUFFC( ) (Función)