Strings.InStr Método

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Sobrecargas

Nome	Description
InStr(Int32, String, String, CompareMethod)	Retorna um inteiro especificando a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra.
InStr(String, String, CompareMethod)	Retorna um inteiro especificando a posição inicial da primeira ocorrência de uma cadeia de caracteres dentro de outra.

InStr(Int32, String, String, CompareMethod)

Retorna um inteiro especificando a posição inicial da primeira ocorrência de uma cadeia de caracteres 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 omitido, a pesquisa começará na posição do primeiro caractere. O índice inicial é baseado em 1.

String1: String

Required. String expressão que está sendo pesquisada.

String2: String

Required. String expressão procurada.

Compare: CompareMethod

Optional. Especifica o tipo de comparação de cadeia de caracteres. Se Compare for omitida, a Option Compare configuração determinará o tipo de comparação.

Retornos

Int32

Se	InStr retorna
`String1` tem comprimento zero ou `Nothing`	0
`String2` tem comprimento zero ou `Nothing`	`start`
`String2` não foi encontrado	0
`String2` é encontrado dentro `String1`	Posição em que a correspondência começa
`Start` > comprimento de `String1`	0

Exceções

ArgumentException

Start < 1.

Exemplos

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

Comentários

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

Observação

A função InStrB em versões anteriores de Visual Basic retorna um número de 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 Visual Basic 2005 estão no Unicode e não há mais suporte para InStrB.

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

Constante	Value	Description
`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)

Retorna um inteiro especificando 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);

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

Required. String expressão que está sendo pesquisada.

String2: String

Required. String expressão procurada.

Compare: CompareMethod

Optional. Especifica o tipo de comparação de cadeia de caracteres. Se Compare for omitida, a Option Compare configuração determinará o tipo de comparação.

Retornos

Int32

Se	InStr retorna
`String1` tem comprimento zero ou `Nothing`	0
`String2` tem comprimento zero ou `Nothing`	A posição inicial da pesquisa, que usa como padrão a posição do primeiro caractere.
`String2` não foi encontrado	0
`String2` é encontrado dentro `String1`	Posição onde a correspondência começa.

Exemplos

Este exemplo usa a InStr função para retornar a posição da primeira ocorrência de uma cadeia de caracteres dentro de outra. No primeiro exemplo, a pesquisa começa a partir do quarto caractere e retorna o próximo "p" de maiúsculas e minúsculas porque CompareMethod não diferencia Text 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

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

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

Confira também

Aplica-se a

Comentários

Esta página foi útil?