BinaryFormat.List

Sintaxe

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

Sobre

Retorna um formato binário que lê uma sequência de itens e retorna uma list. O parâmetro binaryFormat especifica o formato binário de cada item. Há três maneiras 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á aquele número de itens.
• Se o countOrCondition for uma função, essa função será invocada para cada item lido. A função retorna true para continuar e false para interromper a leitura de itens. O item final está incluído na lista.
• Se countOrCondition for um formato binário, será esperado que a contagem de itens preceda a lista e o formato especificado seja usado para ler a contagem.

Exemplo 1

Bytes lidos até o fim dos dados.

Usage

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

Saída

{1, 2, 3}

Exemplo 2

Dois bytes lidos.

Usage

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

Saída

{1, 2}

Exemplo 3

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

Usage

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

Saída

{1, 2}