Função InStr

Devolve a posição de uma cadeia dentro de uma outra cadeia.

A função Instr devolve a posição na qual foi encontrada a correspondência. Se a cadeia não foi encontrada, a função devolve 0.

Sintaxe:


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

Tipo de retorno:

Integer

Parâmetros:

Início: Uma expressão numérica que indica a posição numa cadeia de caracteres onde começa a pesquisa da subcadeia especificada. Se omitir este parâmetro, a pesquisa 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 de cadeia de caracteres que está a ser pesquisada.

String2: A expressão de cadeia de caracteres que pretende pesquisar.

Comparar: Tipo opcional de comparação. O valor pode ser 0 ou 1. O valor predefinido, 1, indica que não se distingue entre maiúsculas e minúsculas. O valor 0 indica que se distingue entre maiúsculas e minúsculas.

A comparação sem distinção entre maiúsculas e minúsculas pode ter em conta as especificidades da configuração regional; por exemplo, «s» pode corresponder a «ß».

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

Códigos de erro

5 Chamada de procedimento inválido

Exemplo:


Sub ExamplePosition
  Const sCalc = "LibreOffice Calc"

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