Strings.InStr メソッド

定義

別の文字列内で最初に出現する文字列の開始位置を指定する整数を返します。 一致が見つかった場合、整数は 1 から始まるインデックスです。 一致するものが見つからない場合、関数は 0 を返します。

オーバーロード

名前 説明
InStr(Int32, String, String, CompareMethod)

別の文字列内で最初に出現する文字列の開始位置を指定する整数を返します。

InStr(String, String, CompareMethod)

別の文字列内で最初に出現する文字列の開始位置を指定する整数を返します。

InStr(Int32, String, String, CompareMethod)

ソース:
Strings.vb
ソース:
Strings.vb
ソース:
Strings.vb
ソース:
Strings.vb
ソース:
Strings.vb

別の文字列内で最初に出現する文字列の開始位置を指定する整数を返します。

public static int InStr(int Start, string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr(int StartPos, string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static int InStr(int StartPos, string String1, string String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
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
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
Public Function InStr (StartPos As Integer, String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

パラメーター

StartStartPos
Int32

このフィールドは省略可能です。 各検索の開始位置を設定する数式を指定します。 省略すると、先頭の文字から検索されます。 開始インデックスは 1 から始まります。

String1
String

必須。 String 検索対象の式。

String2
String

必須。 String 式が必要です。

Compare
CompareMethod

このフィールドは省略可能です。 文字列比較の種類を指定します。 Compareを省略すると、Option Compare設定によって比較の種類が決まります。

返品

もしInStr により返される値
String1 長さが 0 または Nothing0
String2 長さが 0 または Nothing start
String2 が見つかりません0
String2 が次の場所にあります。 String1 一致が始まる位置
Start > の長さ String10

例外

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 関数は文字列の解析時に使用されます。

Note

以前のバージョンの Visual Basic の InStrB 関数は、文字位置ではなくバイト数を返します。 それは主に、2 バイト文字セット (DBCS) アプリケーションで文字列を変換するために使用します。 Visual Basic 2005 のすべての文字列は Unicode で、InStrB はサポートされなくなりました。

Compare引数の設定は次のとおりです。

定数 価値 Description
Binary 0 バイナリ比較を実行します。
Text 1 テキスト比較を実行します。

こちらもご覧ください

適用対象

InStr(String, String, CompareMethod)

ソース:
Strings.vb
ソース:
Strings.vb
ソース:
Strings.vb
ソース:
Strings.vb
ソース:
Strings.vb

別の文字列内で最初に出現する文字列の開始位置を指定する整数を返します。

public static int InStr(string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
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設定によって比較の種類が決まります。

返品

もしInStr により返される値
String1 長さが 0 または Nothing0
String2 長さが 0 または Nothing検索の開始位置。既定では最初の文字位置になります。
String2 が見つかりません0
String2 が次の場所にあります。 String1一致が開始される位置。

この例では、 InStr 関数を使用して、別の文字列内で最初に出現する文字列の位置を返します。 最初の例では、検索は 4 番目の文字から始まり、次の小文字 "p" を返します。 CompareMethodText されるため、大文字と小文字は区別されません。 位置は、開始位置に関係なく、常に文字列の先頭を基準とします。

' 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 関数は文字列の解析時に使用されます。

Note

以前のバージョンの Visual Basic の InStrB 関数は、文字位置ではなくバイト数を返します。 それは主に、2 バイト文字セット (DBCS) アプリケーションで文字列を変換するために使用します。 Visual Basic 2005 のすべての文字列は Unicode で、InStrB はサポートされなくなりました。

Compare引数の設定は次のとおりです。

定数 価値 Description
Binary 0 バイナリ比較を実行します。
Text 1 テキスト比較を実行します。

こちらもご覧ください

適用対象