Compartilhar via


Função InStr (Visual Basic)

Retorna um inteiro especificando a posição de início da primeira ocorrência de uma string dentro da outra.

Public Shared Function InStr(_
   ByVal String1 As String, _
   ByVal String2 As String, _
   Optional ByVal Compare As CompareMethod _
) As Integer
' -or-
Public Shared Function InStr(_
   ByVal Start As Integer, _
   ByVal String1 As String, _
   ByVal String2 As String, _
   Optional ByVal Compare As Microsoft.VisualBasic.CompareMethod _
) As Integer

Parâmetros

  • Start
    Opcional.Expressão numérica que define a posição de início para cada busca.Se omitida, a busca começa na primeira posição de caractere.O índice de início é unicamente baseado.

  • String1
    Obrigatório.String expressão que está sendo pesquisada.

  • String2
    Obrigatório.String expressão procurado.

  • Compare
    Opcional.Especifica o tipo de comparação de strings.Se Compare é omitido, a configuração Option Compare determina o tipo de comparação.

Configurações

As configurações do argumento Compare são:

Constante

Valor

Descrição

Binary

0

Executa uma comparação binária.

Text

1

Executa uma comparação textual.

Valor de retorno

Se

Retornos de InStr

String1 tem comprimento zero ou Nothing

0

String2 tem comprimento zero ou Nothing

start

String2 não é encontrado.

0

String2 é encontrado dentro String1

Posição onde a correspondência começa.

Start > String2

0

Exceções

Tipo de exceção

Número de erro

Condição

ArgumentException

5

Start < 1.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Em geral, a função InStr é usada quando há análise de strings.

Observação:

O InStrB função nas versões anteriores do Visual Basic retorna um número de bytes em vez de uma posição de caractere. Isso é usado primariamente para converter strings em aplicações com conjuntos de caracteres de byte duplo (DBCS).Todas strings do Visual Basic 2005 estão em Unicode, e InStrB não é mais suportado.

Exemplo

Este exemplo usa a função InStr para retornar a posição da primeira ocorrência de uma string dentro da outra.

' String to search in.
Dim SearchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim SearchChar As String = "P"

Dim TestPos As Integer
' A textual comparison starting at position 4. Returns 6.
TestPos = InStr(4, SearchString, SearchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
TestPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
TestPos = InStr(SearchString, SearchChar)

' Returns 0.
TestPos = InStr(1, SearchString, "W")

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**Strings

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Conceitos

Sumário para programação de mudanças em elementos de suporte

Referência

InStrRev função (Visual Basic)

Opção Comparar Declarações

Função StrComp (Visual Basic)

ArgumentException

Outros recursos

Sequências de caracteres em Visual Basic

Introdução a seqüências de caracteres no Visual Basic