Compartilhar via


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.