setString(long pos, java.lang.String str, int offset, int len) - Advanced SQL Engine - Teradata Database

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

Product
Advanced SQL Engine
Teradata Database
Release Number
17.10
Published
2021年7月
Language
日本語
Last Update
2021-09-23
dita:mapPath
ja-JP/rin1593638965306.ditamap
dita:ditavalPath
ja-JP/wrg1590696035526.ditaval
dita:id
B035-1147
Product Category
Software
Teradata Vantage

指定した文字列のすべてまたは一部を、このClobオブジェクトが表わすCLOB値の末尾に付加し、書き込まれた文字数を戻します。

正常に行なわれた場合、setString()は付加された文字数を戻します。

構文

setString(long pos, java.lang.String str, int offset, int len)

構文要素

pos
将来の使用に備えて予約されます。
str
このClobオブジェクトが表わすCLOB値に付加する文字列。
offset
付加する文字の読み込みを開始するstr引数へのオフセット。
len
CLOB値に付加するstr引数からの文字数。

例外

条件 setString()がSQLExceptionをスローする目的
Clob値にアクセスする際にエラーが発生する LOBへのデータの書き込み中にエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7852
JVMが、文字列をClobに書き込むための十分なメモリをメソッドに割り当てることができない 使用できるJVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7856
以下のうちの1つです。
  • str引数がNULLである
  • offset引数の値が負である
  • len引数の値が負である
  • pos引数の値が1より小さい
  • offset + lenの値がstr引数の長さより大きい
Java外部ルーチンが無効な引数でBlobまたはClobメソッドを呼び出したことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “22023”
  • vendorCodeフィールド = 7859