Devuelve una cadena en la que una subcadena especificada se ha reemplazado por otra subcadena un número especificado de veces.
Sintaxis
Reemplazar(expresión, buscar, reemplazar [, iniciar ] [, contar ] [, comparar ] )
La sintaxis de la función Reemplazar tiene los siguientes argumentos:
| Argumento | Descripción |
|---|---|
| expresión | Obligatorio. Expresión de cadena que contiene la subcadena que se va a reemplazar. |
| buscar | Obligatorio. Subcadena que se está buscando. |
| reemplazar | Obligatorio. Subcadena de reemplazo. |
| iniciar | Opcional. Posición dentro de la expresión donde debe comenzar la búsqueda de subcadenas. Si se omite, se asume 1. |
| recuento | Opcional. Número de sustituciones de subcadenas que se van a realizar. Si se omite, el valor predeterminado es -1, lo que significa realizar todas las sustituciones posibles. |
| comparar | Opcional. Valor numérico que indica el tipo de comparación que se va a usar al evaluar subcadenas. Consulte la sección Configuración para ver los valores. |
Configuración
El argumento comparar puede tener los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseCompareOption | –1 | Realiza una comparación utilizando la configuración de la instrucción Option Compare . |
| vbBinaryCompare | 0 | Realiza una comparación binaria. |
| vbTextCompare | 1 | Realiza una comparación textual. |
| vbDatabaseCompare | 2 | Solo Microsoft Office Access 2007. Realiza una comparación basada en la información de la base de datos. |
Valores devueltos
Reemplazar devuelve los siguientes valores:
| Si | Reemplazar devoluciones |
|---|---|
| La expresión es de longitud cero | Cadena de longitud cero ("") |
| la expresión es Nula | Un error. |
| Encontrar es de longitud cero | Copia de expresión. |
| replace es de longitud cero | Copia de la expresión con todas las apariciones de búsqueda eliminadas. |
| iniciar>Len(expresión) | Cadena de longitud cero. La sustitución de las cuerdas comienza en la posición indicada por start. |
| count is 0 | Copia de expresión. |
Observaciones
El valor devuelto por la función Reemplazar es una cadena, con sustituciones realizadas, que comienza en la posición especificada por start y termina al final de la cadena de expresión . No es una copia de la cadena original de principio a fin.
Ejemplo
| Expresión | Resultados |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplacedID FROM ProductSales; | Devuelve el "ProductID", busca "PRO" en "ProductID" y lo reemplaza por "Product" y muestra el resultado en la columna ReplacedID. |