Strings.InStr Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
InStr(Int32, String, String, CompareMethod)	Devolve um inteiro que especifica a posição inicial da primeira ocorrência de uma cadeia dentro de outra.
InStr(String, String, CompareMethod)	Devolve um inteiro que especifica a posição inicial da primeira ocorrência de uma cadeia dentro de outra.

InStr(Int32, String, String, CompareMethod)

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

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

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

Optional. Expressão numérica que define a posição inicial para cada pesquisa. Se for omitida, a procura começa na posição do primeiro caráter. O índice de início é baseado em 1.

String1: String

Required. String a ser revistada.

String2: String

Required. String Procura-se expressão.

Compare: CompareMethod

Optional. Especifica o tipo de comparação de cadeias. Se Compare for omitido, a Option Compare configuração determina o tipo de comparação.

Devoluções

Int32

Se	InStr devolve
`String1` é comprimento zero ou `Nothing`	0
`String2` é comprimento zero ou `Nothing`	`start`
`String2` não é encontrado	0
`String2` encontra-se dentro de `String1`	Posição onde o jogo começa
`Start` > comprimento de `String1`	0

Exceções

ArgumentException

Start < 1.

Exemplos

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

Observações

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

Note

A função InStrB em versões anteriores do Visual Basic devolve um número de bytes em vez de uma posição de carácter. Ele é usado principalmente para converter cadeias de caracteres em aplicativos DBCS (conjunto de caracteres de byte duplo). Todas as cadeias Visual Basic 2005 estão em Unicode, e InStrB já não é suportado.

As Compare definições argumentais são:

Constante	Value	Descrição
`Binary`	0	Realiza uma comparação binária
`Text`	1	Realiza uma comparação de texto

Ver também

Aplica-se a

InStr(String, String, CompareMethod)