Baca dalam bahasa Inggris

Bagikan melalui


Fungsi daftar

Fungsi-fungsi ini membuat dan memanipulasi nilai daftar.

Informasi

Nama Deskripsi
List.Count Mengembalikan jumlah item dalam daftar.
List.NonNullCount Mengembalikan jumlah item dalam daftar yang tidak termasuk nilai null
List.IsEmpty Mengembalikan apakah daftar kosong.

Pilihan

Nama Deskripsi
List.Alternate Mengembalikan daftar dengan item yang diubah dari daftar asli berdasarkan hitungan, repeatInterval opsional, dan offset opsional.
List.Buffer Buffer daftar dalam memori. Hasil dari panggilan ini adalah daftar stabil, yang berarti akan memiliki jumlah determinimik, dan urutan item.
List.Distinct Memfilter daftar ke bawah dengan menghapus duplikat. Nilai kriteria persamaan opsional dapat ditentukan untuk mengontrol perbandingan kesetaraan. Nilai pertama dari setiap grup kesetaraan dipilih.
List.FindText Mencari daftar nilai, termasuk bidang rekaman, untuk nilai teks.
List.First Mengembalikan nilai pertama dari daftar atau default yang ditentukan jika kosong. Mengembalikan item pertama dalam daftar, atau nilai default opsional, jika daftar kosong. Jika daftar kosong dan nilai default tidak ditentukan, fungsi akan ditampilkan.
List.FirstN Mengembalikan kumpulan item pertama dalam daftar dengan menentukan berapa banyak item yang akan dikembalikan atau kondisi kualifikasi yang disediakan oleh countOrCondition.
List.InsertRange Menyisipkan item dari nilai pada indeks yang diberikan dalam daftar input.
List.IsDistinct Mengembalikan apakah daftar berbeda.
List.Last Mengembalikan kumpulan item terakhir dalam daftar dengan menentukan berapa banyak item yang akan dikembalikan atau kondisi kualifikasi yang disediakan oleh countOrCondition.
List.LastN Mengembalikan kumpulan item terakhir dalam daftar dengan menentukan berapa banyak item yang akan dikembalikan atau kondisi yang memenuhi syarat.
List.MatchesAll Mengembalikan true jika semua item dalam daftar memenuhi kondisi.
List.MatchesAny Mengembalikan true jika ada item dalam daftar yang memenuhi kondisi.
List.Positions Mengembalikan daftar posisi untuk daftar input.
List.Range Mengembalikan item hitungan yang dimulai dari offset.
List.Select Memilih item yang cocok dengan kondisi.
List.Single Mengembalikan item tunggal dari daftar atau melempar Expression.Error jika daftar memiliki lebih dari satu item.
List.SingleOrDefault Mengembalikan satu item dari daftar.
List.Skip Melompati item pertama daftar. Mengingat daftar kosong, ia mengembalikan daftar kosong. Fungsi ini mengambil parameter countOrCondition opsional untuk mendukung melompati beberapa nilai.

Fungsi transformasi

Nama Deskripsi
List.Accumulate Mengakumulasi hasil dari daftar. Mulai dari nilai awal seed fungsi ini menerapkan fungsi akumulator dan mengembalikan hasil akhir.
List.Combine Menggabungkan daftar ke dalam satu daftar.
List.ConformToPageReader Fungsi ini hanya ditujukan untuk penggunaan internal.
List.RemoveRange Mengembalikan daftar yang menghapus item hitungan mulai dari offset. Jumlah defaultnya adalah 1.
List.RemoveFirstN Mengembalikan daftar dengan jumlah elemen yang ditentukan yang dihapus dari daftar yang dimulai pada elemen pertama. Jumlah elemen yang dihapus tergantung pada parameter opsional countOrCondition .
List.RemoveItems Menghapus item dari list1 yang ada di list2, dan mengembalikan daftar baru.
List.RemoveLastn Mengembalikan daftar dengan jumlah elemen yang ditentukan yang dihapus dari daftar mulai dari elemen terakhir. Jumlah elemen yang dihapus tergantung pada parameter opsional countOrCondition .
List.Repeat Mengembalikan daftar yang mengulangi konten waktu hitungan daftar input.
List.ReplaceRange Mengembalikan daftar yang menggantikan nilai hitungan dalam daftar dengan daftar yang replaceWith dimulai pada indeks.
List.RemoveMatchingItems Menghapus semua kemunculan nilai yang diberikan dalam daftar.
List.RemoveNulls Menghapus nilai null dari daftar.
List.ReplaceMatchingItems Mengganti kemunculan nilai yang ada dalam daftar dengan nilai baru menggunakan yang disediakan equationCriteria. Nilai lama dan baru disediakan oleh replacements parameter. Nilai kriteria persamaan opsional dapat ditentukan untuk mengontrol perbandingan kesetaraan. Untuk detail operasi penggantian dan kriteria persamaan, buka Nilai parameter.
List.ReplaceValue Mencari daftar nilai untuk nilai dan mengganti setiap kemunculan dengan nilai penggantian.
List.Reverse Mengembalikan daftar yang membalikkan item dalam daftar.
List.Split Memisahkan daftar yang ditentukan menjadi daftar daftar menggunakan ukuran halaman yang ditentukan.
List.Transform Melakukan fungsi pada setiap item dalam daftar dan mengembalikan daftar baru.
List.TransformMany Mengembalikan daftar yang elemennya diproyeksikan dari daftar input.

Fungsi keanggotaan

Karena semua nilai dapat diuji untuk kesetaraan, fungsi-fungsi ini dapat beroperasi melalui daftar heterogen.

Nama Deskripsi
List.AllTrue Mengembalikan true jika semua ekspresi dalam daftar benar
List.AnyTrue Mengembalikan true jika ada ekspresi dalam daftar dalam true
List.Contains Mengembalikan true jika nilai ditemukan dalam daftar.
List.ContainsAll Mengembalikan true jika semua item dalam nilai ditemukan dalam daftar.
List.ContainsAny Mengembalikan true jika ada item dalam nilai yang ditemukan dalam daftar.
List.PositionOf Menemukan kemunculan pertama nilai dalam daftar dan mengembalikan posisinya.
List.PositionOfAny Menemukan kemunculan pertama dari nilai apa pun dalam nilai dan mengembalikan posisinya.

Mengatur operasi

Nama Deskripsi
List.Difference Mengembalikan item dalam daftar 1 yang tidak muncul di daftar 2. Nilai duplikat didukung.
List.Intersect Mengembalikan daftar dari daftar dan memotong item umum dalam daftar individual. Nilai duplikat didukung.
List.Union Mengembalikan daftar dari daftar daftar dan menyabungkan item dalam daftar individual. Daftar yang dikembalikan berisi semua item dalam daftar input apa pun. Nilai duplikat dicocokkan sebagai bagian dari Union.
List.Zip Mengembalikan daftar daftar yang menggabungkan item pada posisi yang sama.

Memesan

Fungsi pengurutan melakukan perbandingan. Semua nilai yang dibandingkan harus sebanding satu sama lain. Ini berarti semuanya harus berasal dari jenis data yang sama (atau termasuk null, yang selalu membandingkan yang terkecil). Jika tidak, Expression.Error akan muncul.

Jenis data yang sebanding meliputi:

  • Angka
  • Durasi
  • WaktuTanggal
  • Teks
  • Logika
  • Null
Nama Deskripsi
List.Max Mengembalikan item maksimum dalam daftar, atau nilai default opsional jika daftar kosong.
List.MaxN Mengembalikan nilai maksimum dalam daftar. Jumlah nilai yang akan dikembalikan atau kondisi pemfilteran harus ditentukan.
List.Median Mengembalikan item median dari daftar.
List.Min Mengembalikan item minimum dalam daftar, atau nilai default opsional jika daftar kosong.
List.MinN Mengembalikan nilai minimum dalam daftar. Jumlah nilai yang akan dikembalikan atau kondisi pemfilteran dapat ditentukan.
List.Sort Mengembalikan daftar yang diurutkan menggunakan kriteria perbandingan.
List.Percentile Mengembalikan satu atau beberapa persentil sampel yang sesuai dengan probabilitas yang diberikan.

Averages

Fungsi-fungsi ini beroperasi melalui daftar Angka, DateTime, dan Durasi yang homogen.

Nama Deskripsi
List.Average Mengembalikan nilai rata-rata dari daftar dalam tipe data nilai dalam daftar.
List.Mode Mengembalikan item yang paling sering muncul dalam daftar.
List.Modes Mengembalikan semua item yang muncul dengan frekuensi maksimum yang sama.
List.StandardDeviation Mengembalikan simpantan baku dari daftar nilai. List.StandardDeviation melakukan perkiraan berbasis sampel. Hasilnya adalah angka untuk angka, dan durasi untuk DateTimes dan Durasi.

Tambahan

Fungsi-fungsi ini bekerja atas daftar Angka atau Durasi yang homogen.

Nama Deskripsi
List.Sum Mengembalikan jumlah dari daftar.

Numerik

Fungsi-fungsi ini hanya berfungsi atas angka.

Nama Deskripsi
List.Covariance Mengembalikan kovarians dari dua daftar sebagai angka.
List.Product Mengembalikan produk dari daftar angka.

Generator

Fungsi-fungsi ini menghasilkan daftar nilai.

Nama Deskripsi
List.Dates Mengembalikan daftar nilai tanggal dari jumlah ukuran, dimulai dari awal dan menambahkan kenaikan ke setiap nilai.
List.DateTimes Mengembalikan daftar nilai tanggalwaktu dari jumlah ukuran, dimulai dari awal dan menambahkan kenaikan ke setiap nilai.
List.DateTimeZones Mengembalikan daftar nilai datetimezone dari jumlah ukuran, mulai dari awal dan menambahkan kenaikan ke setiap nilai.
List.Durations Mengembalikan daftar nilai durasi dari jumlah ukuran, dimulai dari awal dan menambahkan kenaikan ke setiap nilai.
List.Generate Menghasilkan daftar nilai.
List.Numbers Mengembalikan daftar angka dari jumlah ukuran mulai dari awal, dan menambahkan kenaikan. Kenaikan default ke 1.
List.Random Mengembalikan daftar hitungan angka acak, dengan parameter seed opsional.
List.Times Mengembalikan daftar nilai waktu jumlah ukuran, dimulai dari awal.

Nilai Parameter

Spesifikasi kemunculan

Susunan urutan

Kriteria persamaan

Kriteria persamaan untuk nilai daftar dapat ditentukan sebagai:

  • Nilai fungsi yang berupa:
    • Pemilih kunci yang menentukan nilai dalam daftar untuk menerapkan kriteria kesetaraan.
    • Fungsi pembanding yang digunakan untuk menentukan jenis perbandingan yang akan diterapkan. Fungsi comparer bawaan dapat ditentukan—buka Fungsi comparer.
  • Nilai daftar yang memiliki:
    • Tepat dua item.
    • Elemen pertama adalah pemilih kunci seperti yang ditentukan di atas.
    • Elemen kedua adalah pembanding seperti yang ditentukan di atas.

Untuk informasi dan contoh selengkapnya, buka List.Distinct.

Kriteria perbandingan

Kriteria perbandingan dapat disediakan sebagai salah satu nilai berikut:

  • Nilai angka untuk menentukan urutan pengurutan. Untuk informasi selengkapnya, buka Urutan pengurutan.
  • Untuk menghitung kunci yang akan digunakan untuk pengurutan, fungsi dari satu argumen dapat digunakan.
  • Untuk memilih kunci dan urutan kontrol, kriteria perbandingan dapat menjadi daftar yang berisi kunci dan urutan.
  • Untuk sepenuhnya mengontrol perbandingan, fungsi dari dua argumen dapat digunakan yang mengembalikan -1, 0, atau 1 mengingat hubungan antara input kiri dan kanan. Value.Compare adalah metode yang dapat digunakan untuk mendelegasikan logika ini.

Untuk informasi dan contoh selengkapnya, buka List.Sort.

Operasi penggantian

Operasi penggantian ditentukan oleh nilai daftar. Setiap item dari daftar ini harus:

  • Nilai daftar tepat dua item.
  • Item pertama adalah nilai lama dalam daftar, yang akan diganti.
  • Item kedua adalah nilai baru, yang harus menggantikan semua kemunculan nilai lama dalam daftar.