getBytesSection メソッド

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

構文

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

パラメータ

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

srcOffset ソース・バイト配列への、0 から始まる相対オフセット。ソース・オフセットは、0 以上であることが必要です。それ以外の場合は、SQLE_INVALID_PARAMETER エラーが発生します。64K を超えるバッファも許されます。

dst コピー先バイト配列。

dstOffset コピー先バイト配列への、0 から始まる相対オフセット。コピー先オフセットは、0 以上であることが必要です。それ以外の場合は、SQLE_INVALID_PARAMETER エラーが発生します。64K を超えるバッファも許されます。

count 移動するバイト数。count は 0 以上であることが必要です。

戻り値

読み込まれたバイト数。

備考

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

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

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

エラー・セット

SQLE_CONVERSION_ERROR カラムのデータ型が BINARY でも LONG BINARY でもない場合、エラーが発生します。

SQLE_INVALID_PARAMETER カラムのデータ型が BINARY でオフセットが 0 でも 1 でもない、またはデータ長が 0 より小さい場合、エラーが発生します。

カラムのデータ型が LONG BINARY で、オフセットが 1 より小さい場合も、エラーが発生します。