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