Função Substituir

Devolve uma cadeia em que uma Subcadeia especificada foi substituída por outra subcadeia um determinado número de vezes.

Sintaxe

Replace ( expressão, localizar, substituir [, início ] [, contagem ] [, comparar ] )

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

Argumento

Descrição

expressão

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

localizar

Obrigatório. Subcadeia a ser procurada.

substituir

Obrigatório. Subcadeia de substituição.

começar

Opcional. Posicione na expressão em que a pesquisa de subcadeias está a começar. Se omitido, 1 é assumido.

contar

Opcional. Número de substituições de subcadeias a realizar. Se omitido, o valor predefinido é-1, o que significa efetuar todas as substituições possíveis.

comparar

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

Definições

O argumento Compare pode ter os seguintes valores:

Constante

Valor

Descrição

vbUseCompareOption

-1

Efetua uma comparação utilizando a definição da instrução Option Compare .

vbBinaryCompare

0

Efetua uma comparação binária.

vbTextCompare

1

Efetua uma comparação textual.

vbDatabaseCompare

2

apenasMicrosoft Office Access 2007. Efetua uma comparação com base na informação da sua base de dados.

Valores Devolvidos

Substituir devolve os seguintes valores:

Se

Substituir Devoluções

a expressão é de comprimento zero

Cadeia de comprimento zero ("")

a expressão é nula

Um erro.

a localização tem um comprimento zero

Cópia da expressão.

a substituição é de comprimento zero

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

iniciar > Len (expressão)

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

contagem é 0

Cópia da expressão.

Observações

O valor de retorno da função replace é uma cadeia, com as substituições efetuadas, que começam na posição especificada por Start e termina no fim da cadeia de expressão . Não é uma cópia da cadeia original do início para o fim.

Exemplo

Expressão

Resultados

Selecione CódigoDoProduto, substituir (CódigoDoProduto; "PRO"; "produto") como reposicionaid do ProductSales;

Devolve o "CódigoDoProduto", localiza "PRO" em "CódigoDoProduto" e substitui por "produto" e apresenta o resultado na coluna reposicionaid.

Nota:  Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode indicar-nos se estas informações foram úteis? Eis o artigo em inglês para sua referência.​

Consulte Também

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

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×