BinaryFormat.List

Gibt ein Binärformat zurück, das eine Reihe von Elementen liest und eine Liste zurückgibt.

Syntax

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

Remarks

Gibt ein Binärformat zurück, das eine Reihe von Elementen liest und ein list-Element zurückgibt. Der Parameter binaryFormat gibt das Binärformat der einzelnen Elemente an. Die Anzahl der zu lesenden Elemente kann auf drei Arten bestimmt werden:

• Ohne Angabe von countOrCondition liest das Binärformat so lange, bis keine weiteren Elemente vorhanden sind.
• Ist countOrCondition eine Zahl, werden entsprechend viele Elemente gelesen.
• Ist countOrCondition eine Funktion, wird diese für jedes gelesene Element aufgerufen. Die Funktion gibt "true" zurück, um den Vorgang fortzusetzen, oder "false", um das Lesen von Elementen zu beenden. Das finale Element ist in der Liste enthalten.
• Wenn countOrCondition ein Binärformat ist, wird erwartet, dass die Anzahl der Elemente der Liste vorausgeht, und das angegebene Format wird zum Lesen der Anzahl verwendet.

Examples

Example #1

Liest Bytes bis zum Ende der Daten.

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

Result:

{1, 2, 3}

Example #2

Liest zwei Bytes.

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

Result:

{1, 2}

Example #3

Liest Bytes, bis der Bytewert größer oder gleich zwei ist.

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