Conteúdo

# 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

Necessitamos da sua ajuda!