HOME
ID : 5522
WriteByteArray
功能
将变量的值直接按照该变量字节的排列顺序，逐字节保存至字节单位的一维排列（变体型）中。
格式
WriteByteArray(保存源变量,保存位置排列 [,保存开始要素编号 [,保存字节数 ]])指定项目
- 保存源变量
- 指定保存到保存位置排列的值。变体型排列变量以外所有类型的数据。
- 保存位置排列
- 使用变体型数据指定保存位置的排列。
- 保存开始要素编号
- 将数据保存到保存位置排列时，通过整数型数据指定开始保存的要素编号。可省略，省略时指定为0。
- 保存字节数
- 通过整数型数据指定将数据保存到保存位置排列时的数据字节数。最多可指定保存源变量的大小（字节数）。可省略，省略时指定为-1。如果指定-1，保存源变量中的所有数据将被保存到保存位置排列。
返回值
通过整数型数据返回保存位置排列中保存的数据字节数。
解说
按照字节的排列顺序，将保存源变量的值逐字节保存到保存位置排列。
保存时，按照保存位置排列的要素编号从小到大的顺序，从保存源变量从最低字节至最高字节依次保存。
例如，保存源变量为整数型，以16进制数保存&H4030201（10进制为67305985）时，要素编号从0开始，按照1、2、3、4的顺序保存到保存位置排列。
保存源变量为、矢量型、位置型等包含多个要素的类型时，按照要素的排列顺序保存。
例如，由于矢量型中X、Y、Z和要素并列，因此首先从X的最低字节开始按顺序至最高字节，然后从Y的最低字节至最高字节，最后从Z的最低字节至最高字节进行保存。
有关各类型要素的排列顺序，请参照“数据型”。
注意事项
保存位置排列无需事先通过CreateArray等进行一维排列。执行WriteByteArray时，将实际保存的字节数部分初始化为一维排列，保存位置排列的值被保存。
应用示例
'!TITLE "转换成Byte排列
将'I[0]、I[1]的变量作为Byte排列进行二进制发送
Sub Main
Dim Var as Variant
Comm.Open 1
WriteByteArray I[0], Var, 0
WriteByteArray I[1], Var, 4
Comm.Output 1, Var
Comm.Close 1
End SubID : 5522