Strings.InStr Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Bir dizenin başka bir dize içindeki ilk oluşumunun başlangıç konumunu belirten bir tamsayı döndürür. Eşleşme bulunursa tamsayı tek tabanlı bir dizindir. Eşleşme bulunmazsa işlev sıfır döndürür.

Aşırı Yüklemeler

InStr(Int32, String, String, CompareMethod)	Bir dizenin başka bir dize içindeki ilk oluşumunun başlangıç konumunu belirten bir tamsayı döndürür.
InStr(String, String, CompareMethod)	Bir dizenin başka bir dize içindeki ilk oluşumunun başlangıç konumunu belirten bir tamsayı döndürür.

InStr(Int32, String, String, CompareMethod)

Kaynak:

Strings.vb

Bir dizenin başka bir dize içindeki ilk oluşumunun başlangıç konumunu belirten bir tamsayı döndürür.

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

Parametreler

Start

Int32

İsteğe bağlı. Her arama için başlangıç konumunu ayarlayan sayısal ifade. Atlanırsa, arama ilk karakter konumunda başlar. Başlangıç dizini 1 tabanlıdır.

String1

String

Gereklidir. String ifadesi aranıyor.

String2

String

Gereklidir. String ifadesi aranıyor.

Compare

CompareMethod

İsteğe bağlı. Dize karşılaştırma türünü belirtir. Belirtilmezse Compare , Option Compare ayar karşılaştırma türünü belirler.

Döndürülenler

Int32

Eğer	InStr döndürür
String1 sıfır uzunluk veya Nothing	0
String2 sıfır uzunluk veya Nothing	start
String2 bulunamadı	0
String2 içinde bulunur String1	Eşleşmenin başladığı konum
Start > uzunluğu String1	0

Özel durumlar

ArgumentException

Start < 1.

Örnekler

Bu örnekte, bir dizenin InStr başka bir dize içinde ilk geçtiği konumu döndürmek için işlevi kullanılır.

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

Açıklamalar

Genellikle, InStr işlev dizeleri ayrıştırırken kullanılır.

Not

InStrB Visual Basic'in önceki sürümlerindeki işlev, karakter konumu yerine bir dizi bayt döndürür. Esas olarak çift baytlı karakter kümesi (DBCS) uygulamalarında dize dönüştürmek için kullanılır. Tüm Visual Basic 2005 dizeleri Unicode'dadır ve InStrB artık desteklenmemektedir.

Bağımsız Compare değişken ayarları şunlardır:

Sabit	Değer	Açıklama
Binary	0	İkili karşılaştırma yapar
Text	1	Metin karşılaştırması gerçekleştirir

Ayrıca bkz.

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Visual Basic'te Dizeler
• Visual Basic'de Dizelere Giriş
• Option Compare Deyimi

InStr(String, String, CompareMethod)

Kaynak:

Strings.vb

Bir dizenin başka bir dize içindeki ilk oluşumunun başlangıç konumunu belirten bir tamsayı döndürür.

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

Parametreler

String1

String

Gereklidir. String ifadesi aranıyor.

String2

String

Gereklidir. String ifadesi aranıyor.

Compare

CompareMethod

İsteğe bağlı. Dize karşılaştırma türünü belirtir. Belirtilmezse Compare , Option Compare ayar karşılaştırma türünü belirler.

Döndürülenler

Int32

Eğer	InStr döndürür
String1 sıfır uzunluk veya Nothing	0
String2 sıfır uzunluk veya Nothing	Aramanın başlangıç konumu, varsayılan olarak ilk karakter konumuna ayarlanır.
String2 bulunamadı	0
String2 içinde bulunur String1	Eşleşmenin başladığı konum.

Örnekler

Bu örnekte, bir dizenin InStr başka bir dize içinde ilk geçtiği konumu döndürmek için işlevi kullanılır. İlk örnekte, arama dördüncü karakterden başlar ve bundan dolayı büyük/küçük harfe duyarsız olduğundan CompareMethodText sonraki küçük harf "p" değerini döndürür. Konum, başlangıç konumundan bağımsız olarak her zaman dizenin başına göredir.

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

Açıklamalar

Genellikle, InStr işlev dizeleri ayrıştırırken kullanılır.

Not

InStrB Visual Basic'in önceki sürümlerindeki işlev, karakter konumu yerine bir dizi bayt döndürür. Esas olarak çift baytlı karakter kümesi (DBCS) uygulamalarında dize dönüştürmek için kullanılır. Tüm Visual Basic 2005 dizeleri Unicode'dadır ve InStrB artık desteklenmemektedir.

Bağımsız Compare değişken ayarları şunlardır:

Sabit	Değer	Açıklama
Binary	0	İkili karşılaştırma yapar
Text	1	Metin karşılaştırması gerçekleştirir

Ayrıca bkz.

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Visual Basic'te Dizeler
• Visual Basic'de Dizelere Giriş
• Option Compare Deyimi