Função Replace
Retorna uma cadeia de caracteres, que é uma subcadeia de uma expressão de cadeia de caracteres que começa na posição inicial (o padrão é 1), na qual uma subcadeia de caracteres especificada foi substituída por outra subcadeia de caracteres um determinado número de vezes.
Sintaxe
Replace(expresssão, find, replace, [ start, [ count, [ compare ]]])
A sintaxe da função Replace tem estes argumentos nomeados:
| Parte | Descrição |
|---|---|
| expressão | Obrigatório. Expressão de cadeia de caracteres que contém a subcadeia de caracteres a ser substituída. |
| find | Obrigatório. Subcadeia de caracteres procurada. |
| replace | Obrigatório. Subcadeia de caracteres de substituição. |
| start | Opcional. Posição inicial da subcadeia de caracteres da expressão a ser pesquisada e retornada. Se for omitida, será considerada 1. |
| Count | Opcional. Número de substituições de subcadeia de caracteres a ser executado. Caso seja omitido, o valor padrão será -1, ou seja, fazer todas as substituições possíveis. |
| comparação | Opcional. Valor numérico indicando o tipo de comparação a ser usada ao avaliar subcadeias de caracteres. Confira a seção Configurações para obter os valores. |
Configurações
O argumento compare pode ter os seguintes valores:
| Constant | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | -1 | Executa uma comparação usando a configuração da instrução da Option Compare. |
| vbBinaryCompare | 0 | Executa uma comparação binária. |
| vbTextCompare | 1 | Executa uma comparação textual. |
| vbDatabaseCompare | 2 | Somente Microsoft Access. Executa uma comparação baseada nas informações do seu banco de dados. |
Valor de retorno
Replace retorna os seguintes valores:
| Se | Replace retorna |
|---|---|
| expresssão tem comprimento zero | Cadeia de caracteres de comprimento zero ("") |
| expression é Null | Um erro. |
| find tem comprimento zero | Cópia de expresssão. |
| replace tem comprimento zero | Cópia de expresssão com todas as ocorrências de find removidas. |
| start>Len(expresssão) | Cadeia de caracteres de comprimento zero. A cadeia de caracteres de substituição começa na posição indicada por start. |
| count é 0 | Cópia de expresssão. |
Comentários
O valor de retorno da função replace é uma cadeia de caracteres com substituições feitas, começando na posição especificada por start e terminando no final da cadeia de caracteres expresssão. Não é uma cópia da cadeia de caracteres original do início ao fim.
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.