Strings.InStr 方法

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

回傳一個整數，指定一個字串首次出現在另一個字串中的起始位置。 若找到匹配，該整數即為一基數索引。 若未找到匹配，則該函數回傳零。

多載

名稱 Description
InStr(Int32, String, String, CompareMethod)

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

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

InStr(Int32, String, String, CompareMethod)

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

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

參數

StartStartPos
Int32

Optional. 數值表達式，設定每次搜尋的起始位置。 若省略，搜尋從第一個字元位置開始。 起始指數是以1為基礎。

String1
String

必須的。 String 表情被搜尋著。

String2
String

必須的。 String 表情被尋找。

Compare
CompareMethod

Optional. 指定字串比較的類型。 若 Compare 省略，則由 Option Compare 設定決定比較類型。

傳回

Int32
如果InStr 回歸
String1 為零長度或 Nothing0
String2 為零長度或 Nothing start
String2 未被發現0
String2 發現於 String1 比賽開始的位置
Start > 長度 String10

例外狀況

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) 應用程式中轉換字串。 所有 2005 Visual Basic字串皆為 Unicode，且不再支援 InStrB。

Compare參數設定如下：

常數 Value Description
Binary 0 進行二元比較
Text 1 執行文本比較

另請參閱

適用於

InStr(String, String, CompareMethod)

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

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

Optional. 指定字串比較的類型。 若 Compare 省略，則由 Option Compare 設定決定比較類型。

傳回

Int32
如果InStr 回歸
String1 為零長度或 Nothing0
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) 應用程式中轉換字串。 所有 2005 Visual Basic字串皆為 Unicode，且不再支援 InStrB。

Compare參數設定如下：

常數 Value Description
Binary 0 進行二元比較
Text 1 執行文本比較

另請參閱

適用於