|
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.