BinaryFormat.List

Returnerar ett binärformat som läser en sekvens med objekt och returnerar en lista.

Syntax

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

Remarks

Returnerar ett binärformat som läser en sekvens med objekt och returnerar en lista. Parametern binaryFormat anger binärformatet för varje objekt. Det går att fastställa antalet objekt som läses på tre sätt:

• Om countOrCondition inte anges läser binärformatet tills det inte finns fler objekt.
• Om countOrCondition är ett tal läser binärformatet så många objekt.
• Om countOrCondition är en funktion anropas den funktionen för varje läst objekt. Funktionen returnerar true för att fortsätta och false för att sluta läsa objekt. Det sista objektet tas med i listan.
• Om countOrCondition är ett binärformat förväntas uppräkningen av objekt föregå listan, och det angivna formatet används för att läsa antalet.

Examples

Example #1

Läs byte till slutet av data.

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

Result:

{1, 2, 3}

Example #2

Läs två byte.

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

Result:

{1, 2}

Example #3

Läs byte tills bytevärdet är större än eller lika med två.

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