BinaryFormat.List

Returnează un format binar care citeşte o secvenţă de elemente şi returnează o listă.

Syntax

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

Remarks

Returnează un format binar care citește o secvență de elemente și returnează list. Parametrul binaryFormat specifică formatul binar al fiecărui element. Există trei modalități de determinare a numărului de elemente citite:

• Dacă nu se specifică countOrCondition, atunci formatul binar va citi până când nu mai există elemente.
• Dacă countOrCondition este un număr, atunci formatul binar va citi numărul respectiv de elemente.
• Dacă countOrCondition este o funcție, atunci funcția respectivă va fi invocată pentru fiecare element citit. Funcția returnează true pentru a continua și false pentru a opri citirea elementelor. Elementul final este inclus în listă.
• Dacă countOrCondition este un format binar, atunci numărul de elemente este așteptat să apară înaintea listei, iar formatul specificat este utilizat pentru a citi numărul.

Examples

Example #1

Citiţi octeţii până la terminarea datelor.

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

Result:

{1, 2, 3}

Example #2

Citiţi doi octeţi.

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

Result:

{1, 2}

Example #3

Citiţi octeţii până când valoarea pentru octeţi este mai mare sau egală cu doi.

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