17.00 - 17.05 - position(java.lang.String searchstr, long start) - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL外部ルーチン プログラミング

Product
Advanced SQL Engine
Teradata Database
Release Number
17.00
17.05
Published
2020年6月
Content Type
プログラミング リファレンス
Publication ID
B035-1147-170K-JPN
Language
日本語 (日本)

このClobオブジェクトが表わすCLOB値の範囲内で、指定された検索文字列が始まる文字位置を取得します。searchstrの検索は、start位置で開始されます。

引数

引数 説明
searchstr 検索する文字列。
start 検索を開始する位置。

最初の位置は1です。

戻り値

検索が正常に行なわれた場合、position()は検索文字列が開始される位置を戻します。それ以外の場合、position()は-1の値を戻します。

例外

条件 position()がSQLExceptionをスローする目的
CLOB値にアクセスする際にエラーが発生する LOBデータの読み取り中にエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7851
searchstr引数がNULLである

または

start引数の値が1より小さい

無効な引数であることを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “22023”
  • vendorCodeフィールド = 7859
JVMが、指定された文字列を検索するための十分なメモリをメソッドに割り当てることができない 使用できるJVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7856