Compartilhar via


Strings.InStr Método

Definição

Retorna um inteiro que especifica a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra. O inteiro é um índice baseado em um se uma correspondência é encontrada. Se nenhuma correspondência for encontrada, a função retornará zero.

Sobrecargas

InStr(Int32, String, String, CompareMethod)

Retorna um inteiro que especifica a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra.

InStr(String, String, CompareMethod)

Retorna um inteiro que especifica a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra.

InStr(Int32, String, String, CompareMethod)

Origem:
Strings.vb
Origem:
Strings.vb
Origem:
Strings.vb

Retorna um inteiro que especifica a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra.

public static int InStr (int StartPos, string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr (int Start, string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr (int StartPos, string String1, string String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr (int Start, string String1, string String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member InStr : int * string * string * Microsoft.VisualBasic.CompareMethod -> int
static member InStr : int * string * string * Microsoft.VisualBasic.CompareMethod -> int
Public Function InStr (StartPos As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer
Public Function InStr (Start As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Parâmetros

StartStartPos
Int32

Opcional. Expressão numérica que define a posição inicial de cada pesquisa. Se omitida, a pesquisa começa na posição do primeiro caractere. O índice inicial é de base 1.

String1
String

Obrigatórios. Expressão String pesquisada.

String2
String

Obrigatórios. Expressão String solicitada.

Compare
CompareMethod

Opcional. Especifica o tipo de comparação de cadeias de caracteres. Se Compare for omitido, a configuração Option Compare determinará o tipo de comparação.

Retornos

IfInStr retorna
String1 terá tamanho zero ou Nothing0
String2 terá tamanho zero ou Nothing start
String2 não for encontrado0
String2 for encontrado em String1 Posição em que a correspondência começa
Start> que o tamanho de String10

Exceções

Start< 1.

Exemplos

Este exemplo usa a função InStr para retornar a posição da primeira ocorrência de uma cadeia de caracteres 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")

Comentários

Normalmente, a InStr função é usada ao analisar cadeias de caracteres.

Observação

A InStrB função em versões anteriores do Visual Basic retorna vários bytes em vez de uma posição de caractere. Ela é usada principalmente para converter cadeias de caracteres em aplicativos DBCS (conjunto de caracteres de bytes duplos). Todas as cadeias de caracteres do Visual Basic 2005 estão em Unicode e InStrB não têm mais suporte.

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 de texto

Confira também

Aplica-se a

InStr(String, String, CompareMethod)

Origem:
Strings.vb
Origem:
Strings.vb
Origem:
Strings.vb

Retorna um inteiro que especifica a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra.

public static int InStr (string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr (string String1, string String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member InStr : string * string * Microsoft.VisualBasic.CompareMethod -> int
Public Function InStr (String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Parâmetros

String1
String

Obrigatórios. Expressão String pesquisada.

String2
String

Obrigatórios. Expressão String solicitada.

Compare
CompareMethod

Opcional. Especifica o tipo de comparação de cadeias de caracteres. Se Compare for omitido, a configuração Option Compare determinará o tipo de comparação.

Retornos

IfInStr retorna
String1 terá tamanho zero ou Nothing0
String2 terá tamanho zero ou NothingA posição inicial da pesquisa, cujo padrão é a posição do primeiro caractere.
String2 não for encontrado0
String2 for encontrado em String1Posição em que a correspondência começa.

Exemplos

Este exemplo usa a função InStr para retornar a posição da primeira ocorrência de uma cadeia de caracteres dentro da outra. No primeiro exemplo, a pesquisa começa a partir do quarto caractere e retorna a próxima letra minúscula "p" porque CompareMethod é Text e, portanto, não diferencia maiúsculas de minúsculas. A posição é sempre relativa ao início da cadeia de caracteres, independentemente da posição inicial.

' 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")

Comentários

Normalmente, a InStr função é usada ao analisar cadeias de caracteres.

Observação

A InStrB função em versões anteriores do Visual Basic retorna vários bytes em vez de uma posição de caractere. Ela é usada principalmente para converter cadeias de caracteres em aplicativos DBCS (conjunto de caracteres de bytes duplos). Todas as cadeias de caracteres do Visual Basic 2005 estão em Unicode e InStrB não têm mais suporte.

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 de texto

Confira também

Aplica-se a