BinaryFormat.List

Atgriež bināru formātu, kas nolasa vienumu sekvenci un atgriež sarakstu.

Syntax

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

Remarks

Atgriež bināru formātu, kas satur vienumu secību un atgriež sarakstu. Parametrs binaryFormat norāda katra vienuma bināro formātu. Lasīto vienumu skaitu var noteikt trīs veidos.

• Ja vērtība countOrCondition nav norādīta, tad binārais formāts lasīs, līdz vairs nebūs vienumu.
• Ja vērtība countOrCondition ir skaitlis, tad binārais formāts lasīs atbilstšu vienumu daudzumu.
• Ja vērtība countOrCondition ir funkcija, tad šī funkcija tiks izsaukta katram lasītajam vienumam. Funkcija atgriež vērtību “patiess”, lai turpinātu, un vērtību “aplams”, lai pārtrauktu vienumu lasīšanu. Pēdējais vienums tiek iekļauts sarakstā.
• Ja countOrCondition ir binārs formāts, tad tiek sagaidīts, ka vienumu skaits ir pirms saraksta, un skaita lasīšanai tiek izmantots norādītais formāts.

Examples

Example #1

Lasīt baitus līdz datu beigām.

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

Result:

{1, 2, 3}

Example #2

Lasīt divus baitus.

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

Result:

{1, 2}

Example #3

Lasīt baitus, līdz baitu vērtība ir lielāka par vai vienāda ar divi.

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

Result:

{1, 2}

Category

Binary Formats.Reading lists