Retorna uma Cadeia de Caracteres na qual uma substring especificada foi substituída por outra subconsulta um número especificado de vezes.
Sintaxe
Substituir( expressão, localizar, substituir [, iniciar ] [, contar ] [, comparar ] )
A sintaxe substituir função tem esses argumentos:
Argumento |
Descrição |
expressão |
Obrigatório. Expressão de cadeia de caracteres que contém substring a ser substituída. |
localizar |
Obrigatório. Substring sendo pesquisado. |
substituir |
Obrigatório. Subconserção de substituição. |
início |
Opcional. Posicione-se dentro da expressão em que a pesquisa de substring deve começar. Se omitido, 1 será assumido. |
contagem |
Opcional. Número de substituições de substring a serem executadas. Se omitido, o valor padrão será –1, o que significa fazer todas as substituições possíveis. |
comparar |
Opcional. Valor numérico que indica o tipo de comparação a ser usada ao avaliar substrings. Consulte Seção Configurações para obter valores. |
Configurações
O argumento compare pode ter os seguintes valores:
Constante |
Valor |
Descrição |
vbUseCompareOption |
–1 |
Executa uma comparação usando a configuração da instrução Option Compare . |
vbBinaryCompare |
0 |
Executa uma comparação binária. |
vbTextCompare |
1 |
Executa uma comparação textual. |
vbDatabaseCompare |
2 |
Microsoft Office Access 2007 somente. Executa uma comparação com base em informações em seu banco de dados. |
Valores retornados
Substitua retorna os seguintes valores:
If |
Substituir retornos |
expressão é de comprimento zero |
Cadeia de caracteres de comprimento zero ("") |
expressão é Null |
Um erro. |
find é de comprimento zero |
Cópia da expressão. |
replace é de comprimento zero |
Cópia da expressão com todas as ocorrências de localização removidas. |
iniciar > Len(expressão) |
Cadeia de caracteres de comprimento zero. A substituição de cadeia de caracteres começa na posição indicada pelo início. |
contagem é 0 |
Cópia da expressão. |
Comentários
O valor retornado da função Replace é uma cadeia de caracteres, com substituições feitas, que começa na posição especificada pelo início e termina no final da cadeia de caracteres de expressão . Não é uma cópia da cadeia de caracteres original do início ao fim.
Exemplo
Expressão |
Resultados |
SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplaceedID FROM ProductSales; |
Retorna o "ProductID", encontra "PRO" em "ProductID" e substitui por "Product" e exibe o resultado na coluna ReplaceedID. |