Replace (Función)

       

Descripción

Devuelve una cadena en la que se reemplazó una subcadena especificada con otra subcadena un número especificado de veces.

Sintaxis

Replace(expresión, encontrar, reemplazarCon [, inicio[, contar[, comparar]]])

La sintaxis de la función Replace consta de los siguientes argumentos con nombre:

Parte	Descripción
expresión	Requerido. Una expresión de cadena que contiene la subcadena que reemplazar.
encontrar	Requerido. La subcadena que se busca.
reemplazarCon	Requerido. La subcadena de sustitución.
inicio	Opcional. La posición dentro de la expresión donde se empezará a buscar la subcadena. Si se omite, se supone que es 1.
contar	Opcional. El número de sustituciones de subcadenas que se realizarán. Si se omite, el valor predeterminado es –1, que significa que se hagan todas las sustituciones posibles.
comparar	Opcional. El valor númerico que indica la clase de comparación que se realizará cuando se evalúen las subcadenas. Vea la sección Valores para consultar los valores posibles.

Valores

El argumento comparar puede tener los valores siguientes:

Constante	Valor	Descripción
vbUseCompareOption	–1	Realizar una comparación utilizando el valor de la instrucción Option Compare.
vbBinaryCompare	0	Realiza una comparación binaria.
vbTextCompare	1	Realizar una comparación basada en el texto.
vbDatabaseCompare	2	Sólo para Microsoft Access. Realizar una comparación basada en la información de su base de datos.

Valores de retorno

La función Replace devuelve los valores siguientes:

Si	Reemplazar devuelve
expresión es de longitud cero	Una cadena de longitud cero ("").
expresión es Null	Un error.
encontrar es de longitud cero	Una copia de expresión.
reemplazarCon es de longitud cero	Una copia de expresión con todas las apariciones de encontrar quitadas.
inicio > Len(expresión)	Una cadena de longitud cero.
contar es 0	Una copia de expresión.

Comentarios

El valor de retorno de la función Replace es una cadena con sustituciones hechas que comienza en la posición especificada por inicio y concluye al final de la cadena expresión. No es una copia de la cadena original desde el inicio al final.