INSTRファンクション

INSTRファンクション群(INSTR、INSTRB、およびINSTRC)は、文字を使用して文字列からサブストリングを検索し、文字列のうち指定したサブストリングに一致する部分の最初の文字の位置を返します。戻り値となるサブストリング位置の決定方法は各ファンクションで異なります。

INSTRは、入力キャラクタ・セットの定義どおりに文字を使用して長さを計算します。
INSTRBは、バイトを使用して長さを計算します。
INSTRCは、Unicodeの完全文字を使用して長さを計算します。

戻り値

検索が成功した場合はゼロ以外のINTEGER、成功しなかった場合は0(ゼロ)。

構文

{INSTR | INSTRB | INSTRC} (string , substring [, position [, occurrence]])

パラメータ

string

検索元のテキスト式。

substring

検索元で検索する文字列。

position

string内でファンクションが検索を開始する位置を示すゼロ以外のINTEGER。INSTRは、入力キャラクタ・セットでの定義どおりに文字を使用してpositionを計算します。INSTRBは、バイトを使用してpositionを計算します。INSTRCは、Unicodeの完全文字を使用してpositionを計算します。

positionが負数である場合、INSTRはstringの最後から逆方向に数えて検索します。positionのデフォルト値は1なので、ファンクションはstringの最初の位置から検索を開始します。

occurrence

stringでどの一致文字列をファンクションが検索するかを示すINTEGER。occurrenceの値は正数である必要があります。occurrenceのデフォルト値は1なので、ファンクションはsubstringの最初の一致文字列を検索します。

例

例7-127 文字位置を使用したサブストリング位置の順方向検索

次の例は、文字列「Corporate Floor」で文字列「or」の検索を3番目の文字から開始します。「Corporate Floor」で「or」が2回目に出現する位置を返します。

SHOW INSTR('Corporate Floor','or', 3, 2)
14

例7-128 文字位置を使用したサブストリング位置の逆方向検索

この例では、ファンクションは、最後の文字から最後から3番目の文字まで、つまり、「Floor」の最初の「o」まで逆方向にカウントします。次に、ファンクションは2回目に現れる「or」を逆方向に検索し、2回目に現れるこの文字列が、検索文字列の2番目の文字で始まることを認識します。

SHOW INSTR('Corporate Floor','or', -3, 2)
2

例7-129 ダブルバイト・キャラクタ・セットを使用したサブストリング位置の検索

この例では、ダブルバイト・データベース・キャラクタ・セットを使用しているとします。

SHOW INSTRB('Corporate Floor','or',5,2) 
27