Strings.InStr Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Vrátí celé číslo určující počáteční pozici prvního výskytu jednoho řetězce v jiném. Celé číslo je index založený na jednom, pokud se najde shoda. Pokud se nenajde žádná shoda, vrátí funkce nulu.

Přetížení

InStr(Int32, String, String, CompareMethod)	Vrátí celé číslo určující počáteční pozici prvního výskytu jednoho řetězce v jiném.
InStr(String, String, CompareMethod)	Vrátí celé číslo určující počáteční pozici prvního výskytu jednoho řetězce v jiném.

InStr(Int32, String, String, CompareMethod)

Zdroj:

Strings.vb

Vrátí celé číslo určující počáteční pozici prvního výskytu jednoho řetězce v jiném.

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

Parametry

Start

Int32

Nepovinný parametr. Číselný výraz, který nastavuje počáteční pozici pro každé hledání. Pokud ho vynecháte, začne hledání na první pozici znaku. Počáteční index je založený na 1.

String1

String

Povinná hodnota. String hledaný výraz.

String2

String

Povinná hodnota. String výraz hledaný.

Compare

CompareMethod

Nepovinný parametr. Určuje typ porovnání řetězců. Pokud Compare je vynechán, Option Compare určuje typ porovnání nastavení.

Návraty

Int32

Pokud uživatel	Vrátí inStr.
String1 má nulovou délku nebo Nothing	0
String2 má nulovou délku nebo Nothing	start
String2 se nenašel	0
String2 se nachází v rámci String1	Pozice, kde začíná shoda
Start> délka String1	0

Výjimky

ArgumentException

Start< 1.

Příklady

Tento příklad používá InStr funkci k vrácení pozice prvního výskytu jednoho řetězce v jiném.

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

Poznámky

Funkce se InStr obvykle používá při analýze řetězců.

Poznámka

Funkce InStrB v předchozích verzích jazyka Visual Basic vrací místo pozice znaku počet bajtů. Používá se především pro převod řetězců v aplikacích dvoubajtové znakové sady (DBCS). Všechny řetězce jazyka Visual Basic 2005 jsou v kódování Unicode a InStrB už se nepodporují.

Nastavení Compare argumentu jsou:

Konstanta	Hodnota	Popis
Binary	0	Provádí binární porovnání.
Text	1	Provede porovnání textu.

Viz také

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Řetězce v jazyce Visual Basic
• Představení řetězců v jazyce Visual Basic
• Option Compare – příkaz

InStr(String, String, CompareMethod)

Zdroj:

Strings.vb

Vrátí celé číslo určující počáteční pozici prvního výskytu jednoho řetězce v jiném.

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

Parametry

String1

String

Povinná hodnota. String hledaný výraz.

String2

String

Povinná hodnota. String výraz hledaný.

Compare

CompareMethod

Nepovinný parametr. Určuje typ porovnání řetězců. Pokud Compare je vynechán, Option Compare určuje typ porovnání nastavení.

Návraty

Int32

Pokud uživatel	Vrátí inStr.
String1 má nulovou délku nebo Nothing	0
String2 má nulovou délku nebo Nothing	Počáteční pozice pro vyhledávání, která je výchozí pro první pozici znaku.
String2 se nenašel	0
String2 se nachází v rámci String1	Pozice, kde začíná shoda.

Příklady

Tento příklad používá InStr funkci k vrácení pozice prvního výskytu jednoho řetězce v jiném. V prvním příkladu začíná hledání od čtvrtého znaku a vrátí další malá písmena "p", protože CompareMethod nerozlišuje Text velká a malá písmena. Pozice je vždy relativní k začátku řetězce bez ohledu na počáteční pozici.

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

Poznámky

Funkce se InStr obvykle používá při analýze řetězců.

Poznámka

Funkce InStrB v předchozích verzích jazyka Visual Basic vrací místo pozice znaku počet bajtů. Používá se především pro převod řetězců v aplikacích dvoubajtové znakové sady (DBCS). Všechny řetězce jazyka Visual Basic 2005 jsou v kódování Unicode a InStrB už se nepodporují.

Nastavení Compare argumentu jsou:

Konstanta	Hodnota	Popis
Binary	0	Provádí binární porovnání.
Text	1	Provede porovnání textu.

Viz také

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Řetězce v jazyce Visual Basic
• Představení řetězců v jazyce Visual Basic
• Option Compare – příkaz