A função `Substituir` no VBA (Visual Basic for Applications) é usada para substituir ocorrências de uma substring dentro de uma string por outra substring. É semelhante à função `SUBSTITUIR` no Excel, mas é utilizada em macros VBA.
Aqui está a sintaxe básica da função `Substituir` no VBA:
Substituir(Expression, Find, Replace, [Start], [Count], [Compare])
- Expression: A string que você deseja modificar.
- Find: A substring que você deseja localizar dentro de `Expression`.
- Replace: A substring que você deseja usar como substituição para `Find`.
- Start (opcional): A posição dentro de `Expression` em que a substituição deve começar. O valor padrão é 1.
- Count (opcional): O número de substituições a serem feitas. O valor padrão é -1, que indica que todas as ocorrências devem ser substituídas.
- Compare (opcional): O tipo de comparação a ser usada. Pode ser `vbBinaryCompare` (comparação binária – sensível a maiúsculas/minúsculas), `vbTextCompare` (comparação textual – não sensível a maiúsculas/minúsculas), entre outros.
Aqui está um exemplo simples de como usar a função `Substituir` no VBA:
Sub ExemploSubstituir()
Dim textoOriginal As String
Dim textoModificado As String
textoOriginal = "Olá, mundo! Mundo, olá!"
textoModificado = Replace(textoOriginal, "mundo", "Terra")
MsgBox "Texto Original: " & textoOriginal
MsgBox "Texto Modificado: " & textoModificado
End Sub
No exemplo acima, todas as ocorrências da palavra “mundo” na string `textoOriginal` são substituídas por “Terra”, e o resultado é mostrado em uma caixa de mensagem.
Lembre-se de que a função `Replace` no VBA é equivalente à função `Substituir` que você encontra em outras linguagens de programação, mas lembre-se de que a terminologia pode mudar dependendo do ambiente ou linguagem específica que você está usando.