Função Replace

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

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.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
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.

×