Devolve uma Cadeia na qual uma subcadeia especificada foi substituída por outra subcadeia um número especificado de vezes.
Sintaxe
Substituir(expressão, localizar, substituir [, iniciar ] [, contar ] [, comparar ] )
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. |
| Procurar | Obrigatório. Substring a ser procurada. |
| substituir | Obrigatório. Subcadeia de substituição. |
| Início | Opcional. Posição dentro da expressão onde a pesquisa de subcadeia deve começar. Se for omitido, é assumido 1. |
| contagem | Opcional. Número de substituições de substring a serem executadas. Se omitido, o valor padrão é –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 na avaliação de subcadeias. Consulte a secção Definições para obter os valores. |
Configurações
O argumento comparar pode ter os seguintes valores:
| Constante | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | –1 | Efetua uma comparação utilizando a definição da instrução Option Compar . |
| vbBinaryCompare | 0 | Efetua uma comparação binária. |
| vbTextCompare | 1 | Efetua uma comparação textual. |
| vbDatabaseCompare | 2 | Apenas Microsoft Office Access 2007. Efetua uma comparação com base nas informações da sua base de dados. |
Valores Devolvidos
Substituir devolve os seguintes valores:
| Se | Substituir devoluções |
|---|---|
| A expressão é de comprimento zero | Cadeia de comprimento zero ("") |
| expressão é Nula | Um erro. |
| O campo Localizar é de comprimento zero | Cópia da expressão. |
| A substituição é de comprimento zero | Cópia da expressão com todas as ocorrências de localização removidas. |
| Início>Compr(expressão) | Cadeia de comprimento zero. A substituição da cadeia começa na posição indicada pelo início. |
| contagem é 0 | Cópia da expressão. |
Comentários
O valor devolvido da função Substituir é uma cadeia, com substituições efetuadas, que começa na posição especificada por início e termina no fim da cadeia de expressão . Não é uma cópia da cadeia de carateres original do início ao fim.
Exemplo
| Expressão. | Resultados |
|---|---|
| SELECT ProductID, Replace(ProductID,"PRO","Product") COMO ReplacedID FROM ProductSales; | Devolve o valor "IDDoProduto", localiza "PRO" em "IDDoProduto" e substitui por "Produto" e apresenta o resultado na coluna IDDaSubstituição. |