从指定的源偏移量开始，将指定的 SQLType.LONGBINARY 或 SQLType.BINARY 列的内容的子集复制到目标字节数组的指定偏移量处。

语法

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

参数

index   包含二进制数据的列从 1 开始的序号。

srcOffset   源字节数组的零相对偏移。源偏移必须大于或等于 0，否则将引发 SQLE_INVALID_PARAMETER 错误。另外，还允许大于 64K 的缓冲区。

dst   目标字节数组。

dstOffset   目标字节数组的零相对偏移。目标偏移必须大于或等于 0，否则将引发 SQLE_INVALID_PARAMETER 错误。另外，还允许大于 64K 的缓冲区。

count   要移动的字节数。计数必须大于或等于 0。

返回值

读取的字节数。

注释

位于源数组的 srcOffset（从 0 开始）位置到 srcOffset+count-1 位置的字节会分别复制到目标数组的 dstOffset 到 dstOffset+count-1 的位置。如果在复制完指定的字节数之前遇到源值结尾，则目标数组的剩余部分保持不变。

如果以下任何一个条件为 true，则抛出错误，SQLError 代码会设置为 SQLE_INVALID_PARAMETER，并且不会修改目标：

• dst 参数为空值。
• srcOffset 参数为负。
• dstOffset 参数为负。
• count 参数为负。
• dstOffset + count 大于 dst.length（目标数组的长度）。

错误集

SQLE_CONVERSION_ERROR   如果列数据类型不是 BINARY 或 LONG BINARY，则会出现此错误。

SQLE_INVALID_PARAMETER   如果列数据类型为 BINARY 并且偏移不是 0 或 1，或者数据长度小于 0，则会出现此错误。

如果列数据类型为 LONG BINARY，而偏移小于 1，也会出现此错误。