BinaryFormat.Choice
BinaryFormat.Choice(binaryFormat as function, chooseFunction as function, optional type as nullable type, optional combineFunction as nullable function) as function
Returnerer et binærformat som velger det neste binære formatet basert på en verdi som allerede er lest. Den binære formatverdien som produseres av denne funksjonen, fungerer i faser:
- Det binære formatet angitt av
binaryFormat
-parameteren brukes til å lese en verdi. - Verdien sendes til valgfunksjonen som er angitt av
chooseFunction
-parameteren. - Valgfunksjonen undersøker verdien og returnerer et annet binærformat.
- Det andre binære formatet brukes til å lese en annen verdi.
- Hvis kombinasjonsfunksjonen er angitt, sendes de første og andre verdiene til kombineringsfunksjonen, og resultatverdien returneres.
- Hvis kombineringsfunksjonen ikke er angitt, returneres den andre verdien.
- Den andre verdien returneres.
Den valgfrie type
-parameteren angir typen binærformat som returneres av valgfunksjonen. Enten type any
, type list
eller type binary
kan angis. Hvis type
-parameteren ikke er angitt, brukes type any
. Hvis type list
eller type binary
brukes, kan systemet kanskje returnere en strømming binary
eller list
verdi i stedet for en bufret verdi, noe som kan redusere mengden minne som er nødvendig for å lese formatet.
Les en liste over byte der antall elementer bestemmes av den første byten.
bruk
let
binaryData = #binary({2, 3, 4, 5}),
listFormat = BinaryFormat.Choice(
BinaryFormat.Byte,
(length) => BinaryFormat.List(BinaryFormat.Byte, length)
)
in
listFormat(binaryData)
utdata
{3,4}
Les en liste over byte der antall elementer bestemmes av den første byten, og behold den første bytelesingen.
bruk
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)
utdata
[length = 2, list = {3, 4}]
Les en liste over byte der antall elementer bestemmes av den første byten ved hjelp av en strømmingsliste.
bruk
let
binaryData = #binary({2, 3, 4, 5}),
listFormat = BinaryFormat.Choice(
BinaryFormat.Byte,
(length) => BinaryFormat.List(BinaryFormat.Byte, length),
type list
)
in
listFormat(binaryData)
utdata
{3, 4}