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

Devolve uma Cadeia na qual uma subcadeia especificada foi substituída por outra subcadeia um número especificado de vezes.

Sintaxe

Replace( expression, find, replace [, start ] [, count ] [, compare ] )

A sintaxe da função Substituir tem estes argumentos:

Argumento

Descrição

expressão

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

localizar

Obrigatório. Subcadeia a ser procurada.

substituir

Obrigatório. Subcadeia de substituição.

começar

Opcional. Posição na expressão onde a pesquisa de subcadeia deve começar. Se omitido, é assumido 1.

contar

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

comparar

Opcional. Valor numérico que indica o tipo de comparação a utilizar ao avaliar subcadeias. Veja a secção Definições para obter valores.

Definições

O argumento comparar pode ter os seguintes valores:

Constante

Valor

Descrição

vbUseCompareOption

–1

Efetua uma comparação com a definição da instrução Comparação de Opções .

vbBinaryCompare

0

Efetua uma comparação binária.

vbTextCompare

1

Efetua uma comparação textual.

vbDatabaseCompare

2

sóMicrosoft Office Access 2007. Efetua uma comparação com base nas informações na sua base de dados.

Valores Devolvidos

Substituir devolve os seguintes valores:

Se

Substituir devoluções

expressão é de comprimento zero

Cadeia de comprimento zero ("")

expression is Null

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 removidas.

iniciar > Len(expressão)

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

contagem é 0

Cópia da expressão.

Observações

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

Exemplo

Expressão

Resultados

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

Devolve o "ProductID", localiza "PRO" em "ProductID" e substitui por "Product" e apresenta o resultado na coluna ReplaceedID.

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

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.