Skip to main content

BinaryFormat.List

Mengembalikan format perduaan yang membaca jujukan item dan mengembalikan senarai.

Syntax

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

Remarks

Mengembalikan format perduaan yang membaca jujukan item dan mengembalikan list. Parameter binaryFormat menentukan format perduaan bagi setiap item. Terdapat tiga cara untuk menentukan bilangan item yang dibaca:

  • Jika countOrCondition tidak ditentukan, maka format perduaan akan membaca sehingga tiada lagi item.
  • Jika countOrCondition ialah nombor, maka format perduaan akan membaca bilangan item tersebut.
  • Jika countOrCondition ialah fungsi, maka fungsi tersebut akan dijalankan untuk setiap item yang dibaca. Fungsi mengembalikan benar untuk meneruskan dan palsu untuk berhenti membaca item. Item terakhir disertakan dalam senarai.
  • Jika countOrCondition ialah format perduaan, maka kiraan item dijangka mendahului senarai dan format yang ditentukan digunakan untuk membaca kiraan.

Examples

Example #1

Baca bait sehingga hujung data.

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

Result:

{1, 2, 3}

Example #2

Baca dua bait.

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

Result:

{1, 2}

Example #3

Baca bait sehingga nilai bait adalah lebih besar daripada atau sama dengan dua.

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