Função Replace

Observação: Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

Retorna uma cadeia de caracteres na qual uma subcadeia de caracteres especificada foi substituída por outra subcadeia de caracteres um determinado número de vezes.

Sintaxe

Substituir ( expressão, localizar, substituir [comece ] [contagem ] [Comparar ] )

A sintaxe da função Substituir tem os seguintes argumentos:

Argumento

Descrição

expressão

Necessário. Expressão contendo subcadeia de caracteres para substituir de cadeia de caracteres.

localizar

Necessário. Subcadeia de caracteres procurada.

Substituir

Necessário. Subcadeia de caracteres de substituição.

Iniciar

Opcional. Posição dentro de expressão onde pesquisar subcadeia está para começar. Se omitido, será considerado 1.

Contagem

Opcional. Número de substituições de subcadeia para executar. Se omitido, o valor padrão é – 1, o que significa fazer todas as substituições possíveis.

Comparar

Opcional. Valor numérico indicando o tipo de comparação para usar ao avaliar substrings. Consulte a seção configurações para os 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 nas informações no banco de dados.


Retornar valores

Substituir retorna os seguintes valores:

If

Substituir retornará

expressão é de comprimento zero

Cadeia de caracteres de comprimento zero ("")

expressão é Nulo

Um erro.

Localizar é de comprimento zero

Cópia da expressão.

Substituir é de comprimento zero

Cópia da expressão com todas as ocorrências de Localizar removidos.

Iniciar > Len (expressão)

Cadeia de caracteres de comprimento zero.

contagem for 0

Cópia da expressão.


Comentários

O valor de retorno da função Substituir é uma cadeia de caracteres, com substituições feitas, que começa na posição especificada por start e e termina no final da expressão de cadeia de caracteres. Não é uma cópia da cadeia de caracteres original do início ao fim.

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×