BinaryFormat.Choice

语法

BinaryFormat.Choice(binaryFormat as function, chooseFunction as function, optional type as nullable type, optional combineFunction as nullable function) as function

关于

返回一个二进制格式，它基于已读取的值选择下一个二进制格式。 此函数按如下步骤生成二进制格式值：

• 使用 binaryFormat 参数指定的二进制格式读取一个值。
• 将该值传递到 chooseFunction 参数指定的选择函数。
• 该选择函数检查该值并返回第二个二进制格式。
• 使用第二个二进制格式读取第二个值。
• 如果指定了组合函数，则将第一个值和第二个值传递到该组合函数，然后返回生成的值。
• 如果未指定该组合函数，则返回第二个值。
• 返回第二个值。

可选的 type 参数指示选择函数将返回的二进制格式的类型。 可以指定 type any、type list 或 type binary 中的任何一个。 如果未指定 type 参数，则使用 type any。 如果使用 type list 或 type binary，则系统可能会返回流式 binary 或 list 值，而不是缓冲后的值，这可以减少读取该格式所需的内存量。

示例 1

读取字节的列表，其中的元素数目由第一个字节确定。

使用情况

let    binaryData = #binary({ 2, 3, 4, 5 }),    listFormat = BinaryFormat.Choice(        BinaryFormat.Byte,        (length) => BinaryFormat.List(BinaryFormat.Byte, length)    )in    listFormat(binaryData)

输出

{ 3,4 }

示例 2

读取字节的列表，其中的元素数目由第一个字节确定，并且保留读取的第一个字节。

使用情况

let    binaryData = #binary({ 2, 3, 4, 5 }),    listFormat = BinaryFormat.Choice(        BinaryFormat.Byte,        (length) => BinaryFormat.Record([            length = length,            list = BinaryFormat.List(BinaryFormat.Byte, length)        ])    )in    listFormat(binaryData)

输出

[length = 2, list = { 3, 4 }]

示例 3

使用流式列表读取字节的列表，其中的元素数目由第一个字节确定。

使用情况

let    binaryData = #binary({ 2, 3, 4, 5 }),    listFormat = BinaryFormat.Choice(        BinaryFormat.Byte,        (length) => BinaryFormat.List(BinaryFormat.Byte, length),        type list    )in    listFormat(binaryData)

输出

{ 3, 4 }