appendBytes メソッド

指定されたバイト配列の指定されたサブセットを、指定された SQLType.LONGBINARY カラムの新しい値に追加します。

構文

appendBytes(
  UInt16 columnID, 
  Array value, 
  UInt32 srcOffset, 
  UInt32 count
)

パラメータ

columnID カラムの ID 番号。テーブルの最初のカラムの ID 値は 1 です。
value カラムの新しい値。
srcOffset カラムの現在の新しい値に追加する値。
count コピーされるバイト数。

備考

配列 value の srcOffset (0 から始まります) から srcOffset+count-1 までの位置のバイトが、指定されたカラムの値に追加されます。挿入時には、insertBegin は新しい値をカラムのデフォルト値に初期化します。ローのデータは、insert が実行されるまで実際には変更されません。また、その変更がコミットされないかぎり、永続化されません。

次のいずれかに該当する場合、コード SQLCode.SQLE_INVALID_PARAMETER とともにエラーがスローされ、追加先は修正されません。

value 引数が NULL である
srcOffset 引数が負の値である
count 引数が負の値である
srcOffset+count がソース配列の長さ value.length よりも大きい

その他のエラーの場合は、それに応じたエラー・コードとともに SQLException がスローされます。