Retorna uma String na qual uma substring especificada foi substituída por outra substring um número especificado de vezes.
Sintaxe
Replace(expression, find, replace [, start ] [, count ] [, compare ] )
A sintaxe da função Replace tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
| expressão | Obrigatório. Expressão de cadeia de caracteres que contém a subcadeia de caracteres a ser substituída. |
| Encontre | Obrigatório. Substring que está sendo pesquisada. |
| Substitua | Obrigatório. Substring de substituição. |
| Início | Opcional. Posição dentro da expressão em que a pesquisa de subcadeias de caracteres deve começar. Se omitido, 1 será assumido. |
| Contagem | Opcional. Número de substituições de subcadeias de caracteres 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 ser usado ao avaliar subcadeias de caracteres. Consulte a seção Configurações para obter os valores. |
Configurações
O argumento de comparação 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 | Realiza uma comparação textual. |
| vbDatabaseCompare | 2 | Somente Microsoft Office Access 2007. Executa uma comparação com base nas informações do seu banco de dados. |
Valores retornados
Replace retorna os seguintes valores:
| Se | Substituir devoluções |
|---|---|
| a expressão tem comprimento zero | Cadeia de comprimento zero ("") |
| a expressão é Nula | Um erro. |
| Localizar tem comprimento zero | Cópia da expressão. |
| replace is zero-length | Cópia da expressão com todas as ocorrências de localizar removidas. |
| Início>Len(expressão) | Cadeia de comprimento zero. A substituição da cadeia de caracteres começa na posição indicada pelo início. |
| count is 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 por start 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 ReplacedID FROM ProductSales; | Retorna a "ProductID", localiza "PRO" em "ProductID" e substitui por "Product" e exibe o resultado na coluna ReplacedID. |