Bitbybit Docs
    Preparing search index...

    Class Lists

    Membaca, membangun dan membentuk ulang array biasa dari item jenis apa pun. Posisi berbasis 0: indeks 0 adalah item pertama. Sebagian besar metode menerima opsi clone, aktif secara bawaan, yang menyalin daftar secara mendalam terlebih dahulu sehingga masukan tidak pernah diubah; jika dinonaktifkan, metode yang memodifikasi bekerja pada daftar di tempat, yang lebih cepat untuk data besar. removeAllItems selalu mengosongkan daftar yang diberikan kepadanya.

    Index

    Constructors

    add

    • Menyisipkan item pada suatu posisi; item-item dari posisi itu dan seterusnya bergeser naik satu.

      Contoh: [10, 20, 30, 40] dengan 99 pada indeks 2 -> [10, 20, 99, 30, 40]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar dengan item yang disisipkan

      const longer = bitbybit.lists.addItemAtIndex({ list: [10, 20, 30, 40], item: 99, index: 2, clone: true });
      
    • Menyisipkan item yang sama pada beberapa posisi daftar asli.

      Contoh: [10, 20, 30] dengan 99 pada indeks [0, 2] -> [99, 10, 20, 99, 30]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar dengan item yang disisipkan pada setiap indeks

      const marked = bitbybit.lists.addItemAtIndexes({ list: [10, 20, 30], item: 99, indexes: [0, 2], clone: true });
      
    • Menyisipkan beberapa item, yang pertama pada indeks pertama, yang kedua pada indeks kedua, dan seterusnya, semuanya dihitung pada daftar asli.

      Indeks harus dalam urutan menaik dan harus ada satu per item, atau error dipicu. Contoh: [10, 20, 30] dengan item [88, 99] pada indeks [1, 2] -> [10, 88, 20, 99, 30]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar dengan item-item yang disisipkan

      const merged = bitbybit.lists.addItemsAtIndexes({ list: [10, 20, 30], items: [88, 99], indexes: [1, 2], clone: true });
      
    • Menambahkan item di akhir daftar.

      Contoh: [10, 20, 30] menambahkan 40 -> [10, 20, 30, 40]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar dengan item di akhirnya

      const longer = bitbybit.lists.addItem({ list: [10, 20, 30], item: 40, clone: true });
      
    • Menambahkan item di awal daftar.

      Contoh: [10, 20, 30] menambahkan 5 di depan -> [5, 10, 20, 30]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar dengan item di awalnya

      const longer = bitbybit.lists.prependItem({ list: [10, 20, 30], item: 5, clone: true });
      
    • Menambahkan item di awal atau di akhir daftar, sesuai pilihan.

      Contoh: [10, 20, 30] menambahkan 5 di awal -> [5, 10, 20, 30]; di akhir -> [10, 20, 30, 5]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar dengan item yang ditambahkan

      const longer = bitbybit.lists.addItemFirstLast({ list: [10, 20, 30], item: 5, position: Bit.Inputs.Lists.firstLastEnum.first, clone: true });
      
    • Menyambung beberapa daftar menjadi satu, ujung ke ujung.

      Contoh: [[1, 2], [3, 4], [5, 6]] -> [1, 2, 3, 4, 5, 6]

      Type Parameters

      • T

      Parameters

      • inputs: ConcatenateDto<T>

        Daftar-daftar yang digabungkan dan apakah disalin

      Returns T[]

      Satu daftar berisi semua item

      const all = bitbybit.lists.concatenate({ lists: [[1, 2], [3, 4], [5, 6]], clone: true });
      

    create

    • Membuat daftar baru tanpa isi.

      Contoh: -> []

      Returns []

      Daftar kosong

    • Membuat daftar yang memuat item yang sama sejumlah kali.

      Contoh: 5 tiga kali -> [5, 5, 5]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar pengulangan

      const fives = bitbybit.lists.repeat({ item: 5, times: 3 });
      
    • Mengulang pola item berulang-ulang sampai daftar mencapai panjang tertentu.

      Contoh: [1, 2, 3] sampai panjang 7 -> [1, 2, 3, 1, 2, 3, 1]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Pola yang diulang, dipotong sesuai panjang

      const cycle = bitbybit.lists.repeatInPattern({ list: [1, 2, 3], lengthLimit: 7, clone: true });
      

    edit

    • Membalik urutan item-item.

      Contoh: [1, 2, 3, 4, 5] -> [5, 4, 3, 2, 1]

      Type Parameters

      • T

      Parameters

      • inputs: ListCloneDto<T>

        Daftar dan apakah disalin terlebih dahulu

      Returns T[]

      Daftar yang dibalik

    • Menempatkan item-item dalam urutan acak, berbeda pada setiap panggilan.

      Contoh: [1, 2, 3, 4, 5] -> mungkin [3, 1, 5, 2, 4]

      Type Parameters

      • T

      Parameters

      • inputs: ListCloneDto<T>

        Daftar dan apakah disalin terlebih dahulu

      Returns T[]

      Daftar yang diacak

    • Memutar daftar dari daftar ke sisinya: baris menjadi kolom dan kolom menjadi baris.

      Semua daftar dalam harus sama panjang. Contoh: [[0, 1, 2], [3, 4, 5]] -> [[0, 3], [1, 4], [2, 5]]

      Type Parameters

      • T

      Parameters

      • inputs: ListCloneDto<T[]>

        Daftar berisi daftar dan apakah disalin terlebih dahulu

      Returns T[][]

      Daftar berisi daftar yang ditransposisi

      const columns = bitbybit.lists.flipLists({ list: [[0, 1, 2], [3, 4, 5]], clone: true });
      
    • Membagi daftar menjadi kelompok-kelompok berisi n item.

      Item-item yang tersisa di akhir dibuang kecuali keepRemainder aktif, yang menambahkannya sebagai kelompok terakhir yang lebih pendek. Contoh: [0, 1, 2, 3, 4, 5, 6, 7, 8] dalam kelompok 3 -> [[0, 1, 2], [3, 4, 5], [6, 7, 8]]

      Type Parameters

      • T

      Parameters

      • inputs: GroupListDto<T>

        Daftar, ukuran grup dan apakah grup terakhir yang tidak penuh dipertahankan

      Returns T[][]

      Grup-grup, secara berurutan

      const pairs = bitbybit.lists.groupNth({ list: [0, 1, 2, 3, 4], nrElements: 2, keepRemainder: true });
      

    get

    • Membaca item pada suatu posisi dalam daftar, dihitung dari 0.

      Indeks di luar daftar memicu error. Contoh: [10, 20, 30, 40] pada indeks 2 -> 30

      Type Parameters

      • T

      Parameters

      • inputs: ListItemDto<T>

        Daftar, indeks dan apakah item disalin

      Returns T

      Item pada indeks tersebut

      const third = bitbybit.lists.getItem({ list: [10, 20, 30, 40], index: 2, clone: true });
      
    • Membaca item pertama daftar.

      Contoh: [10, 20, 30, 40] -> 10

      Type Parameters

      • T

      Parameters

      Returns T

      Item pertama

    • Membaca item terakhir daftar.

      Contoh: [10, 20, 30, 40] -> 40

      Type Parameters

      • T

      Parameters

      Returns T

      Item terakhir

    • Mempertahankan setiap item daftar dengan probabilitas tertentu dan membuang sisanya, sehingga hasilnya berbeda pada setiap panggilan.

      Contoh: [1, 2, 3, 4, 5] dengan ambang 0.5 -> mungkin [1, 3, 5]

      Type Parameters

      • T

      Parameters

      • inputs: RandomThresholdDto<T>

        Daftar, probabilitas mempertahankan sebuah item dari 0 sampai 1, dan apakah disalin

      Returns T[]

      Item-item yang dipertahankan, dalam urutan aslinya

      const some = bitbybit.lists.randomGetThreshold({ list: [1, 2, 3, 4, 5], threshold: 0.5, clone: true });
      
    • Memotong item-item dari indeks awal sampai, tetapi tidak termasuk, indeks akhir.

      Contoh: [10, 20, 30, 40, 50] dari 1 sampai 4 -> [20, 30, 40]

      Type Parameters

      • T

      Parameters

      • inputs: SubListDto<T>

        Daftar, indeks awal dan akhir, dan apakah disalin

      Returns T[]

      Item-item dalam rentang tersebut

      const middle = bitbybit.lists.getSubList({ list: [10, 20, 30, 40, 50], indexStart: 1, indexEnd: 4, clone: true });
      
    • Mempertahankan setiap item ke-n, mulai dari sebuah offset.

      Contoh: [0, 1, 2, 3, 4, 5, 6, 7, 8] dengan nth 3 dan offset 0 -> [0, 3, 6]; dengan nth 2 dan offset 1 -> [1, 3, 5, 7]

      Type Parameters

      • T

      Parameters

      • inputs: GetNthItemDto<T>

        Daftar, langkah, offset awal, dan apakah disalin

      Returns T[]

      Setiap item ke-n, secara berurutan

      const everyThird = bitbybit.lists.getNthItem({ list: [0, 1, 2, 3, 4, 5, 6, 7, 8], nth: 3, offset: 0, clone: true });
      
    • Mempertahankan item-item di tempat pola true/false yang berulang menyatakan true dan membuang yang lain.

      Pola dimulai lagi dari awal jika habis. Contoh: [0, 1, 2, 3, 4, 5] dengan pola [true, true, false] -> [0, 1, 3, 4]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Item-item yang dipertahankan pola, secara berurutan

      const kept = bitbybit.lists.getByPattern({ list: [0, 1, 2, 3, 4, 5], pattern: [true, true, false] });
      
    • Mengelompokkan ulang daftar-daftar bersarang menurut posisi: item pertama dari setiap daftar digabung bersama, lalu item kedua, dan seterusnya.

      level menyatakan berapa banyak tingkat sarang yang diratakan di dalam setiap daftar terlebih dahulu; 0 mengelompokkan ulang apa adanya. Contoh: [[0, 1, 2], [3, 4, 5]] pada level 0 -> [[0, 3], [1, 4], [2, 5]]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar-daftar yang dikelompokkan ulang

      const columns = bitbybit.lists.mergeElementsOfLists({ lists: [[0, 1, 2], [3, 4, 5]], level: 0 });
      
    • Mengukur daftar terpanjang di antara beberapa daftar.

      Contoh: [[1, 2], [3, 4, 5, 6], [7]] -> 4

      Type Parameters

      • T

      Parameters

      Returns number

      Panjang daftar yang terpanjang

      const longest = bitbybit.lists.getLongestListLength({ lists: [[1, 2], [3, 4, 5, 6], [7]] });
      
    • Memberi tahu apakah sebuah item ada dalam daftar.

      Item dibandingkan menurut identitas, sehingga objek hanya ditemukan jika objek yang persis sama ada dalam daftar. Contoh: [10, 20, 30, 40] memuat 30 -> true, memuat 50 -> false

      Type Parameters

      • T

      Parameters

      Returns boolean

      True jika item ada dalam daftar

      const found = bitbybit.lists.includes({ list: [10, 20, 30, 40], item: 30 });
      
    • Menemukan posisi kemunculan pertama sebuah item, atau -1 jika tidak ada dalam daftar.

      Contoh: [10, 20, 30, 20, 40] mencari 20 -> 1, mencari 50 -> -1

      Type Parameters

      • T

      Parameters

      Returns number

      Indeks berbasis 0, atau -1

      const where = bitbybit.lists.findIndex({ list: [10, 20, 30, 20, 40], item: 20 });
      
    • Mengukur seberapa dalam daftar-daftar bersarang di dalam daftar.

      Contoh: [1, 2, 3] -> 1, [[1, 2], [3, 4]] -> 2, [[[1]]] -> 3

      Parameters

      Returns number

      Jumlah tingkat bersarang

    • Menghitung item-item dalam daftar.

      Contoh: [10, 20, 30, 40, 50] -> 5, [] -> 0

      Type Parameters

      • T

      Parameters

      Returns number

      Jumlah item

    remove

    • Menghapus item pada suatu posisi.

      Contoh: [10, 20, 30, 40, 50] menghapus indeks 2 -> [10, 20, 40, 50]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar tanpa item tersebut

      const shorter = bitbybit.lists.removeItemAtIndex({ list: [10, 20, 30, 40, 50], index: 2, clone: true });
      
    • Menghapus item pertama.

      Contoh: [10, 20, 30, 40] -> [20, 30, 40]

      Type Parameters

      • T

      Parameters

      • inputs: ListCloneDto<T>

        Daftar dan apakah disalin terlebih dahulu

      Returns T[]

      Daftar tanpa item pertamanya

    • Menghapus item terakhir.

      Contoh: [10, 20, 30, 40] -> [10, 20, 30]

      Type Parameters

      • T

      Parameters

      • inputs: ListCloneDto<T>

        Daftar dan apakah disalin terlebih dahulu

      Returns T[]

      Daftar tanpa item terakhirnya

    • Menghapus item yang dihitung dari akhir: indeks 0 adalah item terakhir, 1 yang sebelumnya.

      Contoh: [10, 20, 30, 40, 50] menghapus indeks 1 dari akhir -> [10, 20, 30, 50]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar tanpa item tersebut

      const shorter = bitbybit.lists.removeItemAtIndexFromEnd({ list: [10, 20, 30, 40, 50], index: 1, clone: true });
      
    • Menghapus item-item pada beberapa posisi, semuanya dihitung pada daftar asli.

      Contoh: [10, 20, 30, 40, 50] menghapus indeks [1, 3] -> [10, 30, 50]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar tanpa item-item tersebut

      const kept = bitbybit.lists.removeItemsAtIndexes({ list: [10, 20, 30, 40, 50], indexes: [1, 3], clone: true });
      
    • Mengosongkan daftar yang diberikan, di tempat: array yang sama dikembalikan tanpa item di dalamnya.

      Contoh: [10, 20, 30, 40] -> []

      Type Parameters

      • T

      Parameters

      • inputs: ListDto<T>

        Daftar yang akan dikosongkan

      Returns T[]

      Daftar yang sama, kini kosong

    • Menghapus setiap item ke-n, mulai dari sebuah offset.

      Contoh: [0, 1, 2, 3, 4, 5, 6, 7, 8] dengan nth 3 dan offset 0 -> [1, 2, 4, 5, 7, 8]

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar tanpa setiap item ke-n

      const thinned = bitbybit.lists.removeNthItem({ list: [0, 1, 2, 3, 4, 5, 6, 7, 8], nth: 3, offset: 0, clone: true });
      
    • Membuang setiap item daftar dengan probabilitas tertentu dan mempertahankan sisanya, sehingga hasilnya berbeda pada setiap panggilan.

      Contoh: [1, 2, 3, 4, 5] dengan ambang 0.5 -> mungkin [2, 4]

      Type Parameters

      • T

      Parameters

      • inputs: RandomThresholdDto<T>

        Daftar, probabilitas membuang sebuah item dari 0 sampai 1, dan apakah disalin

      Returns T[]

      Item-item yang bertahan, dalam urutan aslinya

      const some = bitbybit.lists.randomRemoveThreshold({ list: [1, 2, 3, 4, 5], threshold: 0.5, clone: true });
      
    • Menghapus angka-angka yang berulang, mempertahankan kemunculan pertama masing-masing.

      Contoh: [1, 2, 3, 2, 4, 3, 5] -> [1, 2, 3, 4, 5]

      Parameters

      Returns number[]

      Angka-angka tanpa pengulangan, dalam urutan aslinya

    • Menghapus angka-angka yang berada dalam toleransi dari angka yang sudah dipertahankan, sehingga nilai yang hanya berbeda oleh derau floating-point dihitung sama.

      Contoh: [1.0, 1.001, 2.0, 2.002, 3.0] dengan toleransi 0.01 -> [1.0, 2.0, 3.0]

      Parameters

      Returns number[]

      Angka-angka tanpa pengulangan yang berdekatan nilainya, dalam urutan aslinya

      const distinct = bitbybit.lists.removeDuplicateNumbersTolerance({ list: [1.0, 1.001, 2.0], tolerance: 0.01, clone: true });
      
    • Menghapus item-item berulang jenis apa pun, mempertahankan kemunculan pertama masing-masing.

      Item dibandingkan menurut identitas, sehingga dua objek yang tampak setara keduanya tetap ada. Contoh: ['a', 'b', 'c', 'a', 'd', 'b'] -> ['a', 'b', 'c', 'd']

      Type Parameters

      • T

      Parameters

      Returns T[]

      Daftar tanpa pengulangan, dalam urutan aslinya

    sorting

    • Mengurutkan angka dari terendah ke tertinggi, atau dari tertinggi ke terendah.

      Contoh: [5, 2, 8, 1, 9] menaik -> [1, 2, 5, 8, 9]; menurun -> [9, 8, 5, 2, 1]

      Parameters

      • inputs: SortDto<number>

        Angka-angka, arah dan apakah disalin

      Returns number[]

      Angka-angka yang diurutkan

      const sorted = bitbybit.lists.sortNumber({ list: [5, 2, 8, 1, 9], orderAsc: true, clone: true });
      
    • Mengurutkan teks secara alfabetis, dari A ke Z atau dari Z ke A.

      Contoh: ['dog', 'apple', 'cat'] menaik -> ['apple', 'cat', 'dog']

      Parameters

      • inputs: SortDto<string>

        Teks-teks, arah dan apakah disalin

      Returns string[]

      Teks-teks yang diurutkan

      const sorted = bitbybit.lists.sortTexts({ list: ["dog", "apple", "cat"], orderAsc: true, clone: true });
      
    • Mengurutkan objek-objek menurut angka yang dimuat salah satu propertinya.

      Contoh: [{age: 30}, {age: 20}, {age: 25}] menurut 'age' menaik -> [{age: 20}, {age: 25}, {age: 30}]

      Parameters

      • inputs: SortJsonDto<any>

        Objek-objek, properti dasar pengurutan, arah dan apakah disalin

      Returns any[]

      Objek-objek yang diurutkan

      const byAge = bitbybit.lists.sortByPropValue({ list: [{ age: 30 }, { age: 20 }], property: "age", orderAsc: true, clone: true });
      

    transform

    • Menjalin beberapa daftar menjadi satu dengan mengambil item pertama dari masing-masing secara bergiliran, lalu item kedua dari masing-masing, dan seterusnya.

      Daftar yang lebih pendek begitu saja keluar setelah habis. Daftar dari daftar yang kosong memicu error. Contoh: [[0, 1, 2], [3, 4, 5]] -> [0, 3, 1, 4, 2, 5]

      Type Parameters

      • T

      Parameters

      • inputs: InterleaveDto<T>

        Daftar-daftar yang dijalin bersama dan apakah disalin

      Returns T[]

      Satu daftar dengan item-item yang berselang-seling

      const woven = bitbybit.lists.interleave({ lists: [[0, 1, 2], [3, 4, 5]], clone: true });