Strings.InStr 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

傳回整數，指定一個字串在另一個字串內第一次出現的起始位置。 如果找到符合項目，則整數是以一起始的索引。 如果找到相符項目，則函式傳回零。

多載

InStr(Int32, String, String, CompareMethod)	傳回整數，指定一個字串在另一個字串內第一次出現的起始位置。
InStr(String, String, CompareMethod)	傳回整數，指定一個字串在另一個字串內第一次出現的起始位置。

InStr(Int32, String, String, CompareMethod)

來源:

Strings.vb

傳回整數，指定一個字串在另一個字串內第一次出現的起始位置。

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

參數

Start

Int32

選擇性。 數值運算式，可設定每一個搜尋的開始位置。 如果省略，則搜尋會從第一個字元位置開始。 起始索引是以 1 起始的。

String1

String

必要。 正在搜尋的 String 運算式。

String2

String

必要。 找到的 String 運算式。

Compare

CompareMethod

選擇性。 指定字串比較的類型。 如果省略了 Compare，則 Option Compare 設定可決定比較的類型。

傳回

Int32

如果	InStr 會傳回
String1 的長度為零或 Nothing	0
String2 的長度為零或 Nothing	start
String2 找不到。	0
String2 中找到 String1	符合開始的位置
Start>String1 的長度	0

例外狀況

ArgumentException

Start< 1.

範例

此範例使用 InStr 函式傳回某個字串在另一個字串中第一次出現的位置。

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

備註

一般而言，剖 InStr 析字串時會使用函式。

注意

舊版 Visual Basic 中的 函 InStrB 式會傳回位元組數目，而不是字元位置。 其主要用於在雙位元組字元集 (DBCS) 應用程式中轉換字串。 所有 Visual Basic 2005 字串都位於 Unicode 中，不再 InStrB 受到支援。

Compare 引數設定為︰

常數	值	描述
Binary	0	執行二進位比較
Text	1	執行文字比較

另請參閱

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Visual Basic 中的字串
• Visual Basic 中的字串簡介
• Option Compare 陳述式

InStr(String, String, CompareMethod)

來源:

Strings.vb

傳回整數，指定一個字串在另一個字串內第一次出現的起始位置。

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

參數

String1

String

必要。 正在搜尋的 String 運算式。

String2

String

必要。 找到的 String 運算式。

Compare

CompareMethod

選擇性。 指定字串比較的類型。 如果省略了 Compare，則 Option Compare 設定可決定比較的類型。

傳回

Int32

如果	InStr 會傳回
String1 的長度為零或 Nothing	0
String2 的長度為零或 Nothing	搜尋的起始位置，預設為第一個字元位置。
String2 找不到。	0
String2 中找到 String1	比對開始的位置。

範例

此範例使用 InStr 函式傳回某個字串在另一個字串中第一次出現的位置。 在第一個範例中，搜尋會從第四個字元開始，並傳回下一個小寫 「p」，因為 CompareMethod 是 Text 且因此不區分大小寫。 不論開始位置為何，位置一律相對於字串的開頭。

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

備註

一般而言，剖 InStr 析字串時會使用函式。

注意

舊版 Visual Basic 中的 函 InStrB 式會傳回位元組數目，而不是字元位置。 其主要用於在雙位元組字元集 (DBCS) 應用程式中轉換字串。 所有 Visual Basic 2005 字串都位於 Unicode 中，不再 InStrB 受到支援。

Compare 引數設定為︰

常數	值	描述
Binary	0	執行二進位比較
Text	1	執行文字比較

另請參閱

• InStrRev(String, String, Int32, CompareMethod)
• StrComp(String, String, CompareMethod)
• ArgumentException
• Visual Basic 中的字串
• Visual Basic 中的字串簡介
• Option Compare 陳述式