BinaryFormat.List

傳回二進位格式，以讀取項目序列並傳回清單。

Syntax

BinaryFormat.List(
    binaryFormat as function,
    optional countOrCondition as any
) as function

傳回二進位格式，以讀取項目序列並傳回 list。countOrCondition 參數指定每個項目的二進位格式。判斷讀取項目數的方法有三:

如果未指定 countOrCondition，二進位格式會一直讀取到沒有其他任何項目為止。
如果 countOrCondition 是數字，二進位格式會讀取該數量的項目。
如果 binaryFormat 是函數，則針對讀取的每個項目叫用該函數。函數傳回 True 即繼續，傳回 False 則停止讀取項目。最後一個項目包含在清單中。
如果 countOrCondition 是二進位格式，則項目計數必須列在清單前面，系統會使用指定的格式讀取計數。

讀取位元組直到資料結尾。

let
    binaryData = #binary({1, 2, 3}),
    listFormat = BinaryFormat.List(BinaryFormat.Byte)
in
    listFormat(binaryData)

Result:

{1, 2, 3}

讀取兩個位元組。

let
    binaryData = #binary({1, 2, 3}),
    listFormat = BinaryFormat.List(BinaryFormat.Byte, 2)
in
    listFormat(binaryData)

Result:

{1, 2}

讀取位元組，直到位元組值大於或等於二。

let
    binaryData = #binary({1, 2, 3}),
    listFormat = BinaryFormat.List(BinaryFormat.Byte, (x) => x < 2)
in
    listFormat(binaryData)

Result:

{1, 2}