Strings.InStr Método
Definição
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 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 -> intstatic member InStr : int * string * string * Microsoft.VisualBasic.CompareMethod -> intPublic Function InStr (StartPos As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerPublic Function InStr (Start As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerParâ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
| If | InStr retorna |
|---|---|
String1 terá tamanho zero ou Nothing | 0 |
String2 terá tamanho zero ou Nothing |
start
|
String2 não for encontrado | 0 |
String2 for encontrado em String1 | Posição em que a correspondência começa |
Start> que o tamanho de String1 | 0 |
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
- InStrRev(String, String, Int32, CompareMethod)
- StrComp(String, String, CompareMethod)
- ArgumentException
- Cadeias de caracteres no Visual Basic
- Introdução a cadeias de caracteres no Visual Basic
- Instrução Option Compare
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 -> intPublic Function InStr (String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As IntegerParâ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
| If | InStr retorna |
|---|---|
String1 terá tamanho zero ou Nothing | 0 |
String2 terá tamanho zero ou Nothing | A posição inicial da pesquisa, cujo padrão é a posição do primeiro caractere. |
String2 não for encontrado | 0 |
String2 for encontrado em String1 | Posiçã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
- InStrRev(String, String, Int32, CompareMethod)
- StrComp(String, String, CompareMethod)
- ArgumentException
- Cadeias de caracteres no Visual Basic
- Introdução a cadeias de caracteres no Visual Basic
- Instrução Option Compare
