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: The string expression being searched.

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

Compare: Optional type of comparison. The value can be 0 or 1. The default value of 1 specifies case-insensitive. The value of 0 specifies case-sensitive.

note

Case-insensitive comparison may use locale specifics, for example, "s" may match "β".


To avoid a run-time error, do not set the Compare parameter if the Start parameter is omitted.

Códigos de erro:

5 Chamada de procedimento inválida

Exemplo:


Sub ExamplePosition
  Const sCalc = "LibreOffice Calc"

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