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 |
|---|---|---|
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.
.gif "Observação") 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)