Fungsi daftar
Fungsi-fungsi ini membuat dan memanipulasi nilai daftar.
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. |
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. |
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. |
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. |
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. |
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. |
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. |
Fungsi-fungsi ini bekerja atas daftar Angka atau Durasi yang homogen.
Nama | Deskripsi |
---|---|
List.Sum | Mengembalikan jumlah dari daftar. |
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. |
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. |
- Kemunculan.Pertama = 0;
- Kemunculan.Terakhir = 1;
- Kejadian.Semua = 2;
- Order.Ascending = 0;
- Order.Descending = 1;
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 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 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.