このClobオブジェクトが表わすCLOB値の一部またはすべてを、文字列として取得します。
結果の文字列には、位置lengthの文字から始まり、このClobオブジェクトによって指定されるCLOB値から最大でposまでの連続文字が含まれます。
pos + length - 1の値が文字単位のCLOBの長さより大きい場合、結果の文字列の長さはlengthより小さくなります。
構文
getSubString(long pos, int length)
構文要素
- pos
- 抽出されるCLOB値の最初の文字の位置。
- length
- コピーされる連続文字数。
例外
条件 | getSubString()がSQLExceptionをスローする目的 | |||
---|---|---|---|---|
CLOB値にアクセスする際にエラーが発生する | Clobデータの読み取り中にエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
pos引数の値が1より小さい または length引数の値が負である |
無効な引数であることを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
length引数の値が現在のJVMに対して大きすぎるため、この関数に必要なメモリを割り当てることができない | 使用できるJVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
|