このBlobオブジェクトが表わすBLOB値の範囲内で、指定されたバイト配列パターンが始まるバイト位置を取得します。patternの検索は、start位置で開始されます。
検索が正常に行なわれた場合、position()はパターンが表示される位置を戻します。それ以外の場合、position()は-1の値を戻します。
構文
position(byte[] pattern, long start)
構文要素
- pattern
- 検索するパターンを含むバイト配列。
- start
- 検索を開始する位置。
例外
| IF … | position()がSQLExceptionをスローする目的 | |||
|---|---|---|---|---|
| BLOB値にアクセスする際にエラーが発生する | LOBデータの読み取り中にエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
| pattern引数の値がNULLである または start引数の値が1より小さい |
無効な引数であることを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
| JVMが、指定されたパターンを検索するための十分なメモリをメソッドに割り当てることができない | 使用できるJVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
|
|||