Devolve uma Cadeia na qual uma subcadeia especificada foi substituída por outra subcadeia um número especificado de vezes.
Sintaxe
Replace(expression, find, replace [, start ] [, count ] [, compare ] )
A sintaxe da função Substituir tem estes argumentos:
| Argumento | Descrição |
|---|---|
| expressão | Obrigatório. Expressão de cadeia que contém subcadeia para substituir. |
| localizar | Obrigatório. Subcadeia a ser procurada. |
| substituir | Obrigatório. Subcadeia de substituição. |
| iniciar | Opcional. Posição na expressão onde a pesquisa de subcadeia deve começar. Se omitido, é assumido 1. |
| contagem | Opcional. Número de substituições de subcadeia a executar. Se for omitido, o valor predefinido é –1, o que significa fazer todas as substituições possíveis. |
| comparar | Opcional. Valor numérico que indica o tipo de comparação a utilizar ao avaliar subcadeias. Veja a secção Definições para obter valores. |
Configurações
O argumento comparar pode ter os seguintes valores:
| Constante | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | –1 | Efetua uma comparação com a definição da instrução Comparação de Opções . |
| vbBinaryCompare | 0 | Efetua uma comparação binária. |
| vbTextCompare | 1 | Efetua uma comparação textual. |
| vbDatabaseCompare | 2 | Apenas no Microsoft Office Access 2007. Efetua uma comparação com base nas informações na sua base de dados. |
Valores devolvidos
Substituir devolve os seguintes valores:
| Se | Substituir devoluções |
|---|---|
| expressão é de comprimento zero | Cadeia de comprimento zero ("") |
| expression is Null | Um erro. |
| localizar é de comprimento zero | Cópia da expressão. |
| substituir é de comprimento zero | Cópia da expressão com todas as ocorrências de localizar removidas. |
| iniciar>Len(expressão) | Cadeia de comprimento zero. A substituição da cadeia começa na posição indicada por início. |
| contagem é 0 | Cópia da expressão. |
Comentários
O valor devolvido da função Replace é uma cadeia, com substituições efetuadas, que começa na posição especificada por início e termina no final da cadeia de expressão . Não é uma cópia da cadeia original do início ao fim.
Exemplo
| Expressão. | Resultados |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplaceedID FROM ProductSales; | Devolve o "ProductID", localiza "PRO" em "ProductID" e substitui por "Product" e apresenta o resultado na coluna ReplaceedID. |