Função InStr

Retorna a posição de uma string dentro de outra.

A função Instr retorna a posição na qual a cadeia correspondente foi encontrada. Se a cadeia de caracteres não tiver sido encontrada, a função retornará 0.

Sintaxe:


InStr ([Start As Long,] String1 As String, String2 As String[, Compare As Integer]) As Integer

Valor de retorno:

Integer

Parâmetros:

Start: Uma expressão numérica que marca a posição numa cadeia de caracteres onde a busca pela subcadeia de caracteres especificada começa. Se omitir esse parâmetro, a busca começa no primeiro caractere da cadeia. O valor mínimo permitido é 1. O valor máximo permitido é 2,147,483,648.

String1: a expressão do texto a pesquisar.

String2: a expressão da cadeia de caracteres a procurar.

Compare: tipo de comparação opcional. O valor pode ser 0 ou 1. O valor padrão de 1 especifica que a comparação não considera diferença entre maiúsculas e minúsculas. O valor 0 faz a distinção.

A diferenciação entre maiúsculas e minúsculas pode utilizar especificidades da região, por exemplo, "s" pode corresponder a "β", em alemão.

Para evitar um erro em tempo de execução, não defina o parâmetro Compare quando o parâmetro Start for omitido.

Códigos de erro:

5 Chamada de procedimento inválida

Exemplo:


Sub ExamplePosition
  Const sCalc = "LibreOffice Calc"

  Instr(sCalc, "calc")     ' retorna 13
  Instr(String1:=sCalc, String2:="calc", Start:=1)  ' retorna 13
  Instr(11, sCalc, "c")     ' retorna 13
  Instr(11, sCalc, "c",  1) ' retorna 13
  Instr(11, sCalc, "c",  0) ' retorna 16
End Sub