BinaryFormat.List

Retorna um formato binário que lê uma sequência de itens e retorna uma lista.

Syntax

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

Remarks

Retorna um formato binário que lê uma sequência de itens e retorna uma lista. O binaryFormat parâmetro especifica o formato binário de cada item. Há três formas de determinar o número de itens lidos:

• Se o countOrCondition não for especificado, o formato binário será lido até que não haja mais itens.
• Se o countOrCondition for um número, o formato binário lerá muitos itens.
• Se o countOrCondition for uma função, essa função será invocada para cada item lido. A função retorna verdadeiro para continuar e falso para interromper a leitura de itens. O item final é incluído na lista.
• Se o countOrCondition for um formato binário, a contagem de itens deverá preceder a lista e o formato especificado será usado para ler a contagem.

Examples

Example #1

Bytes lidos até o fim dos dados.

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

Result:

{1, 2, 3}

Example #2

Dois bytes lidos.

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

Result:

{1, 2}

Example #3

Bytes lidos até que o valor de byte seja maior ou igual a dois.

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