Replace (Función)
From Visual Basic VBLR
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.