指定されたオフセットで始まる、指定された SQLType.LONGBINARY カラムの内容のサブセットを、コピー先のバイト配列の指定されたオフセットにコピーします。

構文

UInt32 getBytesSection(
   UInt16 index 
   UInt32 srcOffset,
   Array  dst, 
   UInt32 dstOffset,
   UInt32 count  
)

パラメータ

index   バイナリ・データを含むカラムの 1 から始まる順序。

srcOffset   カラム値の開始位置。最初の値は 0 です。

dst   コピー先の配列。

dstOffset   コピー先の配列の開始位置。

count   コピーされるバイト数。

戻り値

読み込まれたバイト数。

備考

コピー元のカラムの srcOffset (0 から始まります) から srcOffset+count-1 までの位置のバイトが、コピー先の配列の dstOffset から dstOffset+count-1 までの位置に、それぞれコピーされます。count のバイト数がコピーされる前に、値の末尾が検出された場合は、コピー先の配列の残りは変更されないままになります。

次のいずれかに該当する場合、エラーがスローされ、Connection.sqlCode が SQLError.SQLE_INVALID_PARAMETER に設定され、コピー先は修正されません。

• dst 引数が NULL である
• srcOffset 引数が負の値である
• dstOffset 引数が負の値である
• count 引数が負の値である
• dstOffset + count がコピー先の配列の長さ dst.length よりも長い