Mencantumkan fungsi
Fungsi-fungsi ini membuat dan memanipulasi nilai daftar.
Informasi
| Nama | Deskripsi |
|---|---|
| List.Count | Mengembalikan jumlah item dalam daftar. |
| List.IsEmpty | Mengembalikan true jika daftar kosong. |
| List.NonNullCount | Mengembalikan jumlah item non-null dalam daftar. |
Pilihan
| Nama | Deskripsi |
|---|---|
| List.Alternate | Mengembalikan daftar yang terdiri dari semua elemen offset bernomor ganjil dalam daftar. |
| List.Buffer | Mem-buffer sebuah daftar. |
| List.Distinct | Mengembalikan daftar nilai di mana duplikat telah dihapus. |
| List.FindText | Mengembalikan daftar nilai (termasuk bidang rekaman) yang berisi teks yang ditentukan. |
| List.First | Mengembalikan nilai pertama dari daftar atau default yang ditentukan jika kosong. |
| List.FirstN | Mengembalikan kumpulan item pertama dalam daftar dengan menentukan berapa banyak item yang akan dikembalikan atau kondisi yang memenuhi syarat. |
| List.InsertRange | Menyisipkan nilai ke dalam daftar pada indeks yang diberikan. |
| List.IsDistinct | Menunjukkan apakah ada duplikat dalam daftar. |
| List.Last | Mengembalikan nilai terakhir dari daftar atau default yang ditentukan jika kosong. |
| List.LastN | Mengembalikan nilai terakhir dalam daftar. Dapat secara opsional menentukan berapa banyak nilai yang akan dikembalikan atau kondisi yang memenuhi syarat. |
| List.MatchesAll | Mengembalikan true jika fungsi kondisi dipenuhi oleh semua nilai dalam daftar. |
| List.MatchesAny | Mengembalikan true jika fungsi kondisi dipenuhi oleh nilai apa pun. |
| List.Positions | Mengembalikan daftar nilai offset untuk input. |
| List.Range | Mengembalikan subset daftar yang dimulai pada offset. |
| List.Select | Mengembalikan daftar nilai yang cocok dengan kondisi. |
| List.Single | Mengembalikan elemen tunggal dari daftar yang panjangnya satu; jika tidak, membangkitkan pengecualian. |
| List.SingleOrDefault | Mengembalikan satu item daftar jika daftar memiliki satu elemen, dan mengembalikan nilai default jika daftar kosong. |
| List.Skip | Mengembalikan daftar yang mengabaikan jumlah elemen yang ditentukan di awal daftar. |
Fungsi transformasi
| Nama | Deskripsi |
|---|---|
| List.Accumulate | Mengumpulkan nilai ringkasan dari daftar item. |
| List.Combine | Mengembalikan satu daftar dengan menggabungkan beberapa daftar. |
| List.ConformToPageReader | Fungsi ini hanya ditujukan untuk penggunaan internal. |
| List.RemoveFirstN | Mengembalikan daftar yang mengabaikan sejumlah elemen yang ditentukan di awal daftar. |
| List.RemoveItems | Menghapus item dari daftar pertama yang ada di daftar kedua. |
| List.RemoveLastN | Mengembalikan daftar yang menghapus jumlah elemen yang ditentukan dari akhir daftar. |
| List.RemoveMatchingItems | Menghapus semua kemunculan nilai input. |
| List.RemoveNulls | Menghapus semua nilai null dari daftar yang ditentukan. |
| List.RemoveRange | Menghapus sejumlah nilai mulai dari posisi yang ditentukan. |
| List.Repeat | Mengembalikan daftar yang merupakan pengulangan count kali dari daftar asli. |
| List.ReplaceMatchingItems | Mengganti kemunculan nilai yang ada dalam daftar dengan nilai baru yang cocok dengan kondisi. |
| List.ReplaceRange | Mengganti count jumlah nilai yang dimulai pada position dengan nilai pengganti. |
| List.ReplaceValue | Mencari daftar untuk nilai yang ditentukan dan menggantinya. |
| List.Reverse | Membalikkan urutan nilai dalam daftar. |
| List.Split | Memisahkan daftar yang ditentukan menjadi daftar daftar menggunakan ukuran halaman yang ditentukan. |
| List.Transform | Mengembalikan daftar nilai baru yang dihitung dari daftar ini. |
| List.TransformMany | Mengembalikan daftar yang elemennya diubah dari daftar input menggunakan fungsi yang ditentukan. |
| List.Zip | Mengembalikan sekumpulan daftar dengan menggabungkan item pada posisi yang sama dalam beberapa daftar. |
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 benar. |
| List.AnyTrue | Mengembalikan benar jika ada ekspresi yang benar. |
| List.Contains | Menunjukkan apakah daftar berisi nilai tersebut. |
| List.ContainsAll | Mengindikasikan di mana sebuah daftar menyertakan semua nilai dalam daftar lain. |
| List.ContainsAny | Menunjukkan di mana daftar menyertakan salah satu nilai dalam daftar lain. |
| List.PositionOf | Mengembalikan offset nilai dalam daftar. |
| List.PositionOfAny | Mengembalikan offset pertama dari nilai dalam daftar. |
Mengatur operasi
| Nama | Deskripsi |
|---|---|
| List.Difference | Mengembalikan selisih dari dua daftar yang diberikan. |
| List.Intersect | Mengembalikan irisan nilai daftar yang ditemukan dalam input. |
| List.Union | Mengembalikan gabungan dari nilai-nilai dalam daftar yang ditemukan di input. |
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, maka akan menghasilkan kesalahan Expression.Error.
Jenis data yang sebanding meliputi:
- Angka
- Durasi
- TanggalWaktu
- Teks
- Logis
- Nol
| Nama | Deskripsi |
|---|---|
| List.Max | Mengembalikan nilai maksimum atau nilai default untuk daftar kosong. |
| List.MaxN | Mengembalikan nilai maksimum dalam daftar. Jumlah nilai yang akan dikembalikan atau kondisi pemfilteran harus ditentukan. |
| List.Median | Mengembalikan nilai median dalam daftar. |
| List.Min | Mengembalikan nilai minimum atau nilai default untuk daftar kosong. |
| List.MinN | Mengembalikan nilai minimum dalam daftar. Jumlah nilai yang akan dikembalikan atau kondisi pemfilteran dapat ditentukan. |
| List.Sort | Mengurutkan daftar data sesuai dengan kriteria yang ditentukan. |
| List.Percentile | Mengembalikan satu atau beberapa persentil sampel yang sesuai dengan probabilitas yang diberikan. |
Rata-rata
Fungsi-fungsi ini beroperasi melalui daftar Angka, DateTime, dan Durasi yang homogen.
| Nama | Deskripsi |
|---|---|
| List.Average | Mengembalikan rata-rata nilai. Bekerja dengan nilai angka, tanggal, tanggalwaktu, zona waktu, dan durasi. |
| List.Mode | Mengembalikan nilai yang paling sering dalam daftar. |
| List.Modes | Mengembalikan daftar nilai yang paling sering dalam daftar. |
| List.StandardDeviation | Mengembalikan perkiraan simpangan baku berbasis sampel. Fungsi ini melakukan perkiraan berbasis sampel. Hasilnya adalah angka untuk angka, dan jangka waktu untuk Tanggal dan Waktu serta Durasi. |
Penambahan
Fungsi-fungsi ini bekerja atas daftar Angka atau Durasi yang homogen.
| Nama | Deskripsi |
|---|---|
| List.Sum | Mengembalikan jumlah item dalam daftar. |
Numerik
Fungsi-fungsi ini hanya berfungsi atas angka.
| Nama | Deskripsi |
|---|---|
| List.Covariance | Mengembalikan kovarians antara dua daftar angka. |
| List.Product | Mengembalikan hasil perkalian angka dalam daftar. |
Generator
Fungsi-fungsi ini menghasilkan daftar nilai.
| Nama | Deskripsi |
|---|---|
| List.Dates | Menghasilkan daftar nilai date berdasarkan nilai awal, jumlah, dan nilai durasi yang meningkat secara bertahap. |
| List.DateTimes | Menghasilkan daftar nilai datetime berdasarkan nilai awal, jumlah, dan nilai durasi yang meningkat bertahap. |
| List.DateTimeZones | Menghasilkan daftar nilai datetimezone berdasarkan nilai awal, jumlah, dan nilai durasi bertahap. |
| List.Durations | Menghasilkan daftar nilai duration yang diberikan nilai awal, hitungan, dan nilai durasi yang bertambah secara bertahap. |
| List.Generate | Menghasilkan daftar nilai. |
| List.Numbers | Mengembalikan daftar angka yang diberi nilai awal, hitungan, dan nilai kenaikan opsional. |
| List.Random | Mengembalikan daftar angka acak. |
| List.Times | Menghasilkan daftar nilai time dengan nilai awal, jumlah, dan nilai durasi yang bertambah secara bertahap. |
Nilai parameter
Spesifikasi terjadinya
- Occurrence.First = 0;
- KemunculanTerakhir. = 1;
- Kejadian.Semua = 2;
Urutan penyortiran
- Order.Ascending = 0;
- Order.Descending = 1;
Kriteria persamaan
Kriteria persamaan untuk nilai daftar dapat ditentukan sebagai:
- Nilai fungsi yang dapat berupa:
- Pemilih kunci yang menentukan nilai dalam daftar untuk menerapkan kriteria kesetaraan.
- Fungsi pembanding yang digunakan untuk menentukan jenis perbandingan yang akan diterapkan. Fungsi pembanding bawaan dapat disesuaikan—pergi ke Fungsi Pembanding.
- Daftar nilai 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 Urutkan urutan.
- 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 dengan daftar nilai. Setiap item dari daftar ini harus:
- Nilai daftar yang tepat hanya dua elemen.
- Item pertama adalah nilai lama dalam daftar, yang akan diganti.
- Item kedua adalah nilai baru, yang harus menggantikan semua kemunculan nilai lama dalam daftar.