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. |
começar |
Opcional. Posição na expressão onde a pesquisa de subcadeia deve começar. Se omitido, é assumido 1. |
contar |
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. |
Definiçõ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 |
só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. |
Observações
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. |