Função InStr do VBScript

Definição e uso

A função InStr pode retornar a posição da primeira ocorrência de uma string em outra string.

A função InStr pode retornar os seguintes valores:

  • Se string1 for "" (sem comprimento) - InStr retorna 0
  • Se string1 for Null - InStr retorna Null
  • Se string2 for "" - InStr retorna start
  • Se string2 for Null - InStr retorna Null
  • Se string2 não for encontrada - InStr retorna 0
  • Se string2 for encontrada em string1, InStr retorna a posição do início da string correspondente encontrada.
  • Se start > Len(string1) - InStr retorna 0

Dica:Veja também Função InStrRev.

Sintaxe

InStr([start,]string1,string2[,compare])
Parâmetros Descrição
start Opcional. Especifica a posição de início da pesquisa. O padrão é o início da string. Se o parâmetro compare já foi especificado, este parâmetro também deve ser especificado.
string1 Obrigatório. A string que precisa ser pesquisada.
string2 Obrigatório. A string a ser pesquisada.
compare

Obrigatório. Especifica o tipo de comparação de string a ser usado. O padrão é 0. Pode usar os seguintes valores:

  • 0 = vbBinaryCompare - Executa comparação binária.
  • 1 = vbTextCompare - Executa comparação textual.

Exemplo

Exemplo 1

dim txt,pos
txt="Este é um belo dia!"
pos=InStr(txt,"his")
document.write(pos)

Saída:

2

Exemplo 2

dim txt,pos
txt="Este é um belo dia!"
Uma comparação textual começando na posição 4
pos=InStr(4,txt,"is",1)
document.write(pos)

Saída:

6

Exemplo 3

dim txt,pos
txt="Este é um belo dia!"
Uma comparação binária começando na posição 1
pos=InStr(1,txt,"B",0)
document.write(pos)

Saída:

0