REGEXP_INSTR

REGEXP_INSTRファンクションは、文字列から指定したパターンを持つサブストリングを検索し、そのサブストリングの位置を返します。

このファンクションでは、入力キャラクタ・セットによって定義された文字を使用して文字列を評価します。

戻り値

パターンが見つかった場合はNUMBER、それ以外の場合は0。

構文

REGEXP_INSTR (source_char, pattern[, position[, occurrence[, return_option[, match_parameter ]]]])

パラメータ

source_char

ファンクションで検索するテキスト式。

pattern

ファンクションで検索するテキスト式。通常は、テキスト・リテラルであり、最大512バイトを含むことができます。ピリオドは任意の文字と一致するワイルドカード文字として解釈されます。

position

source_charの検索を開始する文字を示す正の整数。positionのデフォルト値は1で、source_charの最初の文字から検索を開始します。

occurrence

patternのどの一致文字列を検索するかを示す正の整数。occurrenceのデフォルト値は1で、patternの最初の一致文字列を検索します。

return_option

最初に一致した文字の位置を返す場合(デフォルト)は0(ゼロ)を、一致文字列の次の文字の位置を返す場合は1を指定します。

match_parameter

ファンクションのデフォルトのマッチング動作を変更するテキスト式。次の表に示す値を1つ以上指定できます。

値	指定内容
`c`	大/小文字を区別するマッチング。
`i`	大/小文字を区別しないマッチング。
`m`	ソース文字列を複数行として処理します。`^`(キャレット)および`$`(ドル記号)はそれぞれ、ソース文字列全体の先頭および末尾だけではなく、ソース文字列の任意の位置で任意の行の先頭および末尾として解釈されます。デフォルトでは、ソース文字列を単一行として処理します。
`n`	ピリオド(ワイルドカード文字)と一致する文字に改行文字を含めます。デフォルトでは含まれません。
`x`	空白文字を無視します。

例

次の文

REGEXP_INSTR('Mississippi', 'i', 1, 3)

によって、文字列Mississippiから、文字iの3つ目の出現箇所を検索し、検索は最初の文字から開始されます。値8が返されます。