Função Substituir

Nota: Queremos fornecer-lhe os conteúdos de ajuda mais recentes o mais rapidamente possível e no seu idioma. 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 informar-nos se as informações foram úteis no final desta página? Eis o artigo em inglês para referência.

Devolve uma cadeia em que uma subcadeia especificada foi substituída por outro subcadeia um número especificado de vezes.

Sintaxe

Substituir ( 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 contendo subcadeia a substituir.

localizar

Obrigatório. Subcadeia a ser procurado.

substituir

Obrigatório. Subcadeia de substituição.

Iniciar

Opcional. Posição dentro de expressão onde pesquisa subcadeia está começar. Se for omitido, é assumido 1.

contar

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

Comparar

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


Definições

O argumento Comparar pode ter os seguintes valores:

Constante

Valor

Descrição

vbUseCompareOption

– 1

Executa uma comparação utilizando a definiçã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 na base de dados.


Valores Devolvidos

Substituir devolve os seguintes valores:

Se

Substituir devolve

a expressão é de comprimento zero

Cadeia de comprimento zero ("")

expressão é Nulo

Um erro.

Localizar for de comprimento zero

Cópia da expressão.

Substituir for de comprimento zero

Cópia da expressão com todas as ocorrências do Localizar removidos.

Iniciar > Núm. carat (expressão)

Cadeia de comprimento zero. Substituição de cadeia começa na posição indicada por Iniciar.

contar for 0

Cópia da expressão.


Observações

O valor de retorno da função Substituir é uma cadeia, com substituições efectuadas, que começa na posição especificada por início e conclui no final da cadeia da expressão . Não é uma cópia da cadeia original do princípio ao fim.

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.

×