Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Retorna uma Cadeia de Caracteres na qual uma substring especificada foi substituída por outra subconsulta um número especificado de vezes.

Sintaxe

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

A sintaxe substituir função tem esses argumentos:

Argumento

Descrição

expressão

Obrigatório. Expressão de cadeia de caracteres que contém substring a ser substituída.

localizar

Obrigatório. Substring sendo pesquisado.

substituir

Obrigatório. Subconserção de substituição.

início

Opcional. Posicione-se dentro da expressão em que a pesquisa de substring deve começar. Se omitido, 1 será assumido.

contagem

Opcional. Número de substituições de substring 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 usada ao avaliar substrings. Consulte Seção Configurações para obter 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 em informações em seu banco de dados.

Valores retornados

Substitua retorna os seguintes valores:

If

Substituir retornos

expressão é de comprimento zero

Cadeia de caracteres de comprimento zero ("")

expressão é Null

Um erro.

find é de comprimento zero

Cópia da expressão.

replace é de comprimento zero

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

iniciar > Len(expressão)

Cadeia de caracteres de comprimento zero. A substituição de cadeia de caracteres começa na posição indicada pelo início.

contagem é 0

Cópia da expressão.

Comentários

O valor retornado da função Replace é uma cadeia de caracteres, com substituições feitas, que começa na posição especificada pelo início 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

SELECT ProductID, Replace(ProductID,"PRO","Product") AS ReplaceedID FROM ProductSales;

Retorna o "ProductID", encontra "PRO" em "ProductID" e substitui por "Product" e exibe o resultado na coluna ReplaceedID.

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

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.

As comunidades ajudam você a fazer e responder perguntas, fazer comentários e ouvir especialistas com conhecimento avançado.