INSTR 関数は、指定されたオフセットから LOB モードで n 回目にマッチする位置を返します。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
DBMS_LOB.INSTR (
lob_loc IN BLOB,
pattern IN RAW,
offset IN INTEGER := 1,
nth IN INTEGER := 1)
RETURN INTEGER;
DBMS_LOB.INSTR (
lob_loc IN CLOB CHARACTER SET ANY_CS,
pattern IN VARCHAR2 CHARACTER SET ANY_CS,
offset IN INTEGER := 1,
nth IN INTEGER := 1)
RETURN INTEGER;
パラメータの説明
パラメータ |
説明 |
|---|---|
| lob_loc | チェック対象の LOB のロケーター。詳細については、DBMS_LOB使用説明を参照してください。 |
| pattern | テストするパターン。このパターンは、BLOB 用の RAW バイトの集合と、CLOB 用の文字列（VARCHAR）で構成されます。パターンの最大サイズは16383バイトです。 |
| offset | パターンマッチングが開始されるバイト（BLOB）または文字（CLOB）の絶対オフセット（原点は1）。 |
| nth | マッチ回数。1から計算されます。 |
戻り値
戻り値 |
説明 |
|---|---|
| INTEGER | マッチパターンの開始オフセット。バイトまたは文字単位です。パターンが見つからない場合は0を返します。 |
| NULL | 以下のいずれかの場合があります：
|
使用方法
VARCHAR バッファの形式（pattern パラメータ）は、CLOB パラメータの形式と一致している必要があります。LOB パラメータの型が CLOB の場合、バッファには CHAR データが含まれていなければなりません。
RAW または VARCHAR パラメータを使用したパターンマッチング操作（例：INSTR）では、パターンパラメータや部分文字列で正規表現や特殊なマッチング文字（例：SQLの LIKE）はサポートされません。