Strings.InStr Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Zwraca liczbę całkowitą określającą pozycję początkową pierwszego wystąpienia jednego ciągu w innym. Liczba całkowita jest jednym indeksem, jeśli zostanie znalezione dopasowanie. Jeśli nie zostanie znalezione dopasowanie, funkcja zwróci zero.

Przeciążenia

InStr(Int32, String, String, CompareMethod)	Zwraca liczbę całkowitą określającą pozycję początkową pierwszego wystąpienia jednego ciągu w innym.
InStr(String, String, CompareMethod)	Zwraca liczbę całkowitą określającą pozycję początkową pierwszego wystąpienia jednego ciągu w innym.

InStr(Int32, String, String, CompareMethod)

Źródło:

Strings.vb

Zwraca liczbę całkowitą określającą pozycję początkową pierwszego wystąpienia jednego ciągu w innym.

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

Opcjonalny. Wyrażenie liczbowe, które ustawia pozycję początkową dla każdego wyszukiwania. Jeśli pominięto, wyszukiwanie zaczyna się od pierwszego położenia znaku. Indeks początkowy jest oparty na 1.

String1

String

Wymagane. String wyszukiwane wyrażenie.

String2

String

Wymagane. String wyrażenie szukało.

Compare

CompareMethod

Opcjonalny. Określa typ porównania ciągów. Jeśli Compare zostanie pominięte, Option Compare ustawienie określa typ porównania.

Zwraca

Int32

Jeśli użytkownik	Funkcja InStr zwraca
String1 ma zerową długość lub Nothing	0
String2 ma zerową długość lub Nothing	start
String2 nie można odnaleźć	0
String2 znajduje się w obrębie String1	Położenie, w którym rozpoczyna się dopasowanie
Start> długość String1	0

Wyjątki

ArgumentException

Start< 1.

Przykłady

W tym przykładzie InStr użyto funkcji, aby zwrócić położenie pierwszego wystąpienia jednego ciągu w innym.

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

Uwagi

InStr Zazwyczaj funkcja jest używana podczas analizowania ciągów.

Uwaga

Funkcja InStrB w poprzednich wersjach programu Visual Basic zwraca liczbę bajtów, a nie pozycję znaku. Służy przede wszystkim do konwersji ciągów w aplikacjach z zestawami dwubajtowych znaków (znaków DBCS). Wszystkie ciągi języka Visual Basic 2005 są w formacie Unicode i InStrB nie są już obsługiwane.

Ustawienia argumentów Compare to:

Stała	Wartość	Opis
Binary	0	Wykonuje porównanie binarne
Text	1	Wykonuje porównanie tekstu

Zobacz też

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Ciągi w języku Visual Basic
• Wprowadzenie do ciągów w Visual Basic
• Option Compare — Instrukcja

InStr(String, String, CompareMethod)

Źródło:

Strings.vb

Zwraca liczbę całkowitą określającą pozycję początkową pierwszego wystąpienia jednego ciągu w innym.

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

Wymagane. String wyszukiwane wyrażenie.

String2

String

Wymagane. String wyrażenie szukało.

Compare

CompareMethod

Opcjonalny. Określa typ porównania ciągów. Jeśli Compare zostanie pominięte, Option Compare ustawienie określa typ porównania.

Zwraca

Int32

Jeśli użytkownik	Funkcja InStr zwraca
String1 ma zerową długość lub Nothing	0
String2 ma zerową długość lub Nothing	Pozycja początkowa wyszukiwania, która jest domyślnie ustawiona na pierwszą pozycję znaku.
String2 nie można odnaleźć	0
String2 znajduje się w obrębie String1	Położenie, w którym rozpoczyna się dopasowanie.

Przykłady

W tym przykładzie InStr użyto funkcji, aby zwrócić położenie pierwszego wystąpienia jednego ciągu w innym. W pierwszym przykładzie wyszukiwanie rozpoczyna się od czwartego znaku i zwraca następny mniejszy przypadek "p", ponieważ CompareMethod jest Text i dlatego bez uwzględniania wielkości liter. Pozycja jest zawsze względna względem początku ciągu, niezależnie od pozycji początkowej.

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

Uwagi

InStr Zazwyczaj funkcja jest używana podczas analizowania ciągów.

Uwaga

Funkcja InStrB w poprzednich wersjach programu Visual Basic zwraca liczbę bajtów, a nie pozycję znaku. Służy przede wszystkim do konwersji ciągów w aplikacjach z zestawami dwubajtowych znaków (znaków DBCS). Wszystkie ciągi języka Visual Basic 2005 są w formacie Unicode i InStrB nie są już obsługiwane.

Ustawienia argumentów Compare to:

Stała	Wartość	Opis
Binary	0	Wykonuje porównanie binarne
Text	1	Wykonuje porównanie tekstu

Zobacz też

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Ciągi w języku Visual Basic
• Wprowadzenie do ciągów w Visual Basic
• Option Compare — Instrukcja