Função Replace

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

Sintaxe

Substituir ( expressão, localizar, substituir [, iniciar ] [, contar ] [, comparar ] )

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

Argumento

Descrição

expressão

Obrigatório. Expressão de cadeia de caracteres que contém subcadeia de caracteres para substituir.

localizar

Obrigatório. Subcadeia de caracteres que está sendo pesquisada.

substituir

Obrigatório. Subcadeia de caracteres de substituição.

início

Opcional. Posição dentro da expressão em que a pesquisa de subcadeia de caracteres deve começar. Se omitido, 1 será presumido.

contagem

Opcional. Número de substituições de subcadeias de caracteres a serem executadas. Se omitido, o valor padrão será – 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 ver 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 apenas. Executa uma comparação com base nas informações do seu banco de dados.

Valores de retorno

Substituir retorna os seguintes valores:

If

Substituir Devoluções

a expressão é de comprimento zero

Cadeia de caracteres de comprimento zero ("")

a expressão é nula

Um erro.

Localizar é de comprimento zero

Cópia da expressão.

substituir é zero-length

Cópia da expressão com todas as ocorrências de Find removidas.

iniciar > Len (expressão)

Cadeia de comprimento zero. A substituição da cadeia de caracteres começa na posição indicada por Start.

contagem é 0

Cópia da expressão.

Comentários

O valor de retorno 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

SELECIONE ProductID, Replace (ProductID, "PRO", "produto") como reposicionaid de ProductSales;

Retorna o "ProductID", localiza "PRO" em "ProductID" e substitui por "Product" e exibe o resultado em reposicionaid da coluna.

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Consulte Também

As funções de cadeia de caracteres e como usá-las

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