Devuelve una cadena en la que una subcadena especificada se ha reemplazado por otra subcadena un número especificado de veces.
Sintaxis
Replace(expression, find, replace [, start ] [, count ] [, compare ] )
La sintaxis de la función Reemplazar tiene estos 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 supone que es 1. |
| contar | Opcional. Número de sustituciones de subcadenas que se realizarán. 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 usará al evaluar subcadenas. Vea la sección Configuración para los valores. |
Configuración
El argumento comparar puede tener los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseCompareOption | –1 | Realiza una comparación con 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 |
|---|---|
| expresión es de longitud cero | Cadena de longitud cero ("") |
| expresión es Null | Un error. |
| buscar es de longitud cero | Copia de la expresión. |
| reemplazar es de longitud cero | Copia de expresión con todas las ocurrencias de la búsqueda quitada. |
| iniciar>Len(expr) | Cadena de longitud cero. La sustitución de cadena comienza en la posición indicada por inicio. |
| el recuento es 0 | Copia de la expresión. |
Observaciones
El valor devuelto de la función Reemplazar es una cadena, con sustituciones realizadas, que comienza en la posición especificada por inicio y finaliza 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 "IdProducto", busca "PRO" en "IdProducto" y lo reemplaza por "Producto" y muestra el resultado en la columna Id. reemplazado. |