指定した文字列を、このClobオブジェクトが表わすCLOB値の末尾に付加し、書き込まれた文字数を戻します。
正常に行なわれた場合、setString()は書き込まれた文字数を戻します。
構文
setString(long pos, java.lang.String str)
構文要素
- pos
- pos引数は、将来の使用に備えて予約されます。
- str
- このClobオブジェクトが表わすCLOB値に付加する文字列。
例外
条件 | setString()がSQLExceptionをスローする目的 | |||
---|---|---|---|---|
CLOB値にアクセスする際にエラーが発生する | LOBへのデータの書き込み中にエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
str引数がNULLである または pos引数の値が1より小さい |
Java外部ルーチンが無効な引数でBLOBまたはCLOBメソッドを呼び出したことを示し、SQLExceptionフィールドを以下のように設定します。
|
|||
JVMが、文字列をClobに書き込むための十分なメモリをメソッドに割り当てることができない | 使用できるJVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
|