関連項目

ある文字列 (string1) の中から指定した文字列 (string2) を検索し、最初に見つかった文字位置 (先頭からその位置までの文字数) を返す文字列処理関数です。

構文

InStr([start, ]string1, string2[, compare])

Instr 関数の構文は、次の指定項目から構成されます。

指定項目	内容
start	省略可能です。検索の開始位置を表す数式を指定します。引数 start を省略すると、先頭の文字から検索されます。引数 start に Null 値が含まれている場合、エラーが発生します。引数 compare を指定した場合は、引数 start も指定する必要があります。
string1	必ず指定します。検索対象となる文字列式を指定します。
string2	必ず指定します。引数 string1 内で検索する文字列式を指定します。
compare	省略可能です。文字列式を評価するときに使用する文字列比較のモードを表す数値を指定します。引数 compare を省略すると、バイナリ モードで比較が行われます。設定する値については、次の「設定値」を参照してください。

設定値

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

定数	値	内容
vbBinaryCompare	0	バイナリ モードの比較を行います。
vbTextCompare	1	テキスト モードの比較を行います。
vbDatabaseCompare	2	比較を行うデータベースに格納されている方法に基づいて比較を行います。

戻り値

Instr 関数の戻り値は次のとおりです。

条件	Instr の戻り値
string1 が長さ 0 の文字列 ("") のとき	0
string1 が Null 値のとき	Null 値
string2 が長さ 0 の文字列 ("") のとき	start
string2 が Null 値のとき	Null 値
string2 が見つからないとき	0
string2 が string1 内で見つかったとき	見つかった文字列の位置
start の値が string2 の文字数より大きいとき	0

解説

メモ  文字列をバイト データとして扱う場合は、InStrB 関数を使用してください。InStrB 関数は検索結果をバイト位置 (先頭からその位置までのバイト数) で返します。