Conteúdo
Índice 🔎︎

# Função Replace

Substitui um texto por outro.

### Sintaxe:

Replace (Texto As String, PesqTexto As String, SubstTexto As String [, Inicio As Long [, Contagem as long [, Comparar As Boolean]]]

### Valor de retorno:

Expressão

### Parâmetros:

Texto: qualquer expressão em caracteres que pretenda modificar.

PesqTexto: qualquer expressão de texto a ser pesquisada.

SubstTexto: Qualquer expressão de texto que substituirá o texto encontrado na pesquisa.

Início: expressão numérica que indica a posição do carácter na cadeia onde começa a parte do texto que pretende substituir ou devolver. O valor máximo permitido é 65535.

Contagem: o número máximo de substituições a fazer.

Comparar: expressão numérica opcional que define o tipo de comparação. O valor deste parâmetro poder ser VERDADEIRO ou FALSO. O valor padrão é VERDADEIRO, e especifica uma comparação de texto, não sensível a maiúsculas e minúsculas. O valor FALSO especifica uma comparação binária sensível a maiúsculas e minúsculas. Pode-se utilizar 0 em vez de FALSO, e 1 em vez de VERDADEIRO.

## Códigos de erro

5 Chamada de procedimento inválido

### Exemplo:

            msgbox replace ("aBbcnnbnn", "b", "$", 1, 1, FALSE) 'devolve "aB$cnnbnn"
            REM sendo que: "b" deveria ser substituído, mas
            REM * apenas quando em minúsculas (parâmetro 6), daí uma segunda ocorrência de "b"
            REM * apenas a primeira ocorrência (parâmetro 5) que obedece a maíusculas/minúsuclas