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）はサポートされていません。