BinaryFormat.List

Sintaxe

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

Sobre nós

Retorna um formato binário que lê uma sequência de itens e retorna um 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á esse 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 parar de ler itens. O último item está incluído na lista.
• Se o countOrCondition for um formato binário, espera-se que a contagem de itens preceda a lista e o formato especificado seja usado para ler a contagem.

Exemplo 1

Leia bytes até ao final dos dados.

Utilização

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

Saída

{1, 2, 3}

Exemplo 2

Leia dois bytes.

Utilização

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

Saída

{1, 2}

Exemplo 3

Leia bytes até que o valor do byte seja maior ou igual a dois.

Utilização

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

Saída

{1, 2}