BinaryFormat.Choice

Повертає двійковий формат, який вибирає наступний двійковий формат на основі значення, яке вже було прочитано.

Syntax

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

Remarks

Повертає двійковий формат, який вибирає наступний двійковий формат на основі значення, яке вже було прочитано. Значення двійкового формату, яке повертається цією функцією, працює за такими етапами.

• Читається значення за допомогою двійкового формату, указаного параметром binaryFormat.
• Значення передається функції вибору, указаній параметром chooseFunction.
• Функція вибору перевіряє значення та повертає другий двійковий формат.
• Другий двійковий формат використовується для читання другого значення.
• Якщо вказано функцію групування, їй передаються перше та друге значення, після чого вона повертає значення результату.
• Якщо функцію групування не вказано, повертається друге значення.
• Повертається друге значення.

Необов'язковий параметр type вказує тип двійкового формату, який поверне функція вибору. Можна вказати type any, type list або type binary. Якщо параметр type не вказано, використовується type any. Якщо використовується type list або type binary, система може мати змогу повернути потокове передавання binary або значення list замість буферизованого, що може зменшити потребу в обсязі пам'яті, необхідної для читання формату.

Examples

Example #1

Прочитати список байтів, де кількість елементів визначається першим байтом.

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

Result:

{3, 4}

Example #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)

Result:

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

Example #3

Прочитати список байтів, де кількість елементів визначається першим байтом, за допомогою списку потокового передавання.

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

Result:

{3, 4}

Category

Binary Formats.Controlling what comes next