BinaryFormat.Choice

Retourneert een binaire indeling die de volgende binaire indeling kiest op basis van een waarde die al is gelezen.

Syntax

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

Remarks

Retourneert een binaire indeling die de volgende binaire indeling kiest op basis van een waarde die al is gelezen. De waarde van een binaire indeling die door deze functie wordt geproduceerd, werkt in stadia:

• De binaire indeling die is opgegeven met de parameter binaryFormat wordt gebruikt om een waarde te lezen.
• De waarde wordt doorgegeven aan de keuzefunctie die is opgegeven met de parameter chooseFunction.
• De keuzefunctie inspecteert de waarde en retourneert een secundaire binaire indeling.
• De secundaire binaire indeling wordt gebruikt om een tweede waarde te lezen.
• Als de combineerfunctie is opgegeven, worden de eerste en tweede waarden doorgegeven aan de combineerfunctie en wordt de resulterende waarde geretourneerd.
• Als de combineerfunctie niet is opgegeven, wordt de tweede waarde geretourneerd.
• De tweede waarde wordt geretourneerd.

De optionele parameter type geeft het type binaire indeling aan dat wordt geretourneerd door de keuzefunctie. type any, type list of type binary kan worden opgegeven. Als de parameter type niet is opgegeven, wordt type any gebruikt. Als type list of type binary wordt gebruikt, kan het systeem een gestreamde binary waarde of listwaarde retourneren in plaats van een gebufferde waarde waardoor de beschikbare hoeveelheid geheugen voor het lezen van de indeling kan worden verminderd.

Examples

Example #1

Een lijst met bytes lezen waarvan het aantal elementen wordt bepaald door de eerste byte.

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

Een lijst met bytes lezen waarvan het aantal elementen wordt bepaald door de eerste byte, en de leesbewerking van de eerste byte bewaren.

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

Een lijst met bytes lezen waarvan het aantal elementen wordt bepaald door de eerste byte met behulp van een gestreamde lijst.

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