Liste işlevleri
Bu işlevler liste değerlerini oluşturup işler.
Bilgi
| Adı | Açıklama |
|---|---|
| List.Count | Listedeki öğe sayısını döndürür. |
| List.NonNullCount | Null değerleri hariç tutarak listedeki öğe sayısını döndürür |
| List.IsEmpty | Listenin boş olup olmadığını döndürür. |
Seçim
| Adı | Açıklama |
|---|---|
| List.Alternate | Bir sayı, isteğe bağlı repeatInterval parametresi ve isteğe bağlı kaydırma değeri kullanarak özgün listedeki seçilen öğelerden oluşan bir liste döndürür. |
| List.Buffer | Listeyi arabelleğe alır. Bu çağrının sonucunda kararlı bir liste elde edilir. Bunun anlamı, listedeki öğelerin sayısının ve sırasının belirli olduğudur. |
| List.Distinct | Yinelenenleri kaldırarak listeyi filtreler. Eşitlik karşılaştırmasını denetlemek için isteğe bağlı bir denklem ölçütü değeri belirtilebilir. Her eşitlik grubundaki ilk öğe seçilir. |
| List.FindText | Kayıt alanları dahil olmak üzere değerler listesinde belirtilen metin değerini arar. |
| List.First | Listenin ilk değerini veya boşsa belirtilen varsayılanı döndürür. Listenin ilk değerini veya liste boşsa isteğe bağlı varsayılan değeri döndürür. Liste boşsa ve varsayılan değer belirtilmemişse işlev döndürülür. |
| List.FirstN | Döndürülecek öğe sayısını veya tarafından countOrConditionsağlanan uygun bir koşulu belirterek listedeki ilk öğe kümesini döndürür. |
| List.InsertRange | Giriş listesindeki belirtilen dizinden başlayarak değerleri ekler. |
| List.IsDistinct | Listenin benzersiz olup olmadığını döndürür. |
| List.Last | Döndürülecek öğe sayısını veya tarafından countOrConditionsağlanan uygun bir koşulu belirterek listedeki son öğe kümesini döndürür. |
| List.LastN | Döndürülecek öğe sayısı veya bir uygun koşul belirtilerek listedeki son öğe kümesini döndürür. |
| List.MatchesAll | Listedeki tüm öğelerin belirtilen koşulu karşılaması durumunda true değerini döndürür. |
| List.MatchesAny | Listedeki öğelerden herhangi birinin belirtilen koşulu karşılaması durumunda true değerini döndürür. |
| List.Positions | Giriş listesinin konum listesini döndürür. |
| List.Range | Kaydırma değerinden başlayarak öğe sayısını döndürür. |
| List.Select | Bir koşulla eşleşen öğeleri seçer. |
| List.Single | Listenin tek bir öğesini döndürür veya listede birden fazla öğe varsa bir Expression.Error oluşturur. |
| List.SingleOrDefault | Listeden tek bir öğe döndürür. |
| List.Skip | Listenin ilk öğesini atlar. Liste boşsa boş listeyi döndürür. Bu işlev, birden çok değerin atlanması için isteğe bağlı bir parametre countOrCondition alır. |
Dönüştürme işlevleri
| Adı | Açıklama |
|---|---|
| List.Accumulate | Listeden toplama yoluyla bir sonuç elde eder. Bu işlev, başlangıç çekirdek değerinden itibaren toplama işlevini uygular ve nihai sonucu döndürür. |
| List.Combine | Listelerden oluşan bir listeyi birleştirerek tek bir liste oluşturur. |
| List.ConformToPageReader | Bu işlev yalnızca şirket içi kullanım için tasarlanmıştır. |
| List.RemoveRange | Kaydırma değerinden başlayarak belirtilen sayıda öğenin kaldırıldığı bir liste döndürür. Varsayılan olarak 1 değeri kullanılır. |
| List.RemoveFirstN | İlk öğeden başlayarak listeden belirtilen sayıda öğenin kaldırılmasıyla oluşturulan listeyi döndürür. Kaldırılan öğelerin sayısı isteğe bağlı countOrCondition parametreye bağlıdır. |
| List.RemoveItems | içinde bulunan list2öğeleri kaldırır list1 ve yeni bir liste döndürür. |
| List.RemoveLastN | Son öğeden başlayarak listeden belirtilen sayıda öğenin kaldırılmasıyla oluşturulan listeyi döndürür. Kaldırılan öğelerin sayısı isteğe bağlı countOrCondition parametreye bağlıdır. |
| List.Repeat | Giriş listesinin içeriğinin belirli sayıda yinelenmesiyle oluşturulan listeyi döndürür. |
| List.ReplaceRange | Listedeki sayı değerlerini dizinden başlayan bir listeyle değiştiren bir replaceWith liste döndürür. |
| List.RemoveMatchingItems | Listedeki verilen değerlerin tüm oluşumlarını kaldırır. |
| List.RemoveNulls | Listedeki null değerleri kaldırır. |
| List.ReplaceMatchingItems | Sağlanan equationCriteriaöğesini kullanarak listedeki mevcut değerlerin oluşumlarını yeni değerlerle değiştirir. Eski ve yeni değerler parametreler tarafından replacements sağlanır. Eşitlik karşılaştırmalarını denetlemek için isteğe bağlı bir eşitlik ölçütü değeri belirtilebilir. Değiştirme işlemleri ve denklem ölçütlerinin ayrıntıları için Parametre değerleri'ne gidin. |
| List.ReplaceValue | Değeri için bir değer listesi arar ve her oluşumu değiştirme değeri ile değiştirir. |
| List.Reverse | Listedeki öğeleri tersine çeviren bir liste döndürür. |
| List.Split | Belirtilen sayfa boyutunu kullanarak belirtilen listeyi bir listeler listesine böler. |
| List.Transform | İşlevi listedeki her öğeye uygular ve yeni listeyi döndürür. |
| List.TransformMany | Öğeleri giriş listesinden yansıtılan bir liste döndürür. |
Üyelik işlevleri
Tüm değerlerde eşitlik testi yapılabildiğinden bu işlevler heterojen listelerle çalışabilir.
| Adı | Açıklama |
|---|---|
| List.AllTrue | Listedeki tüm ifadeler true ise true değerini döndürür |
| List.AnyTrue | Listedeki ifadelerden biri true ise true değerini döndürür |
| List.Contains | Listede bir değer bulunursa true değerini döndürür. |
| List.ContainsAll | Değerlerdeki tüm öğeler listede bulunursa true değerini döndürür. |
| List.ContainsAny | Değerlerdeki öğelerden biri listede bulunursa true değerini döndürür. |
| List.PositionOf | Değerin listede ilk geçtiği yeri bulur ve konumunu döndürür. |
| List.PositionOfAny | Değerlerden birinin listede ilk geçtiği yeri bulur ve konumunu döndürür. |
Küme işlemleri
| Adı | Açıklama |
|---|---|
| List.Difference | Liste 1 içinde görünüp liste 2 içinde görünmeyen öğeleri döndürür. Yinelenen değerler desteklenir. |
| List.Intersect | Listeler listesinden bir liste döndürür ve listeler arasındaki ortak öğeleri belirtir. Yinelenen değerler desteklenir. |
| List.Union | Listeler listesinden bir liste döndürür ve listeleri birleştirir. Döndürülen liste, giriş listelerindeki tüm öğeleri içerir. Birleşim işlemi kapsamında yinelenen değerler eşleştirilir. |
| List.Zip | Aynı konumdaki öğeleri bir araya getirerek listelerin bulunduğu bir liste döndürür. |
Sıralama
Sıralama işlevleri, karşılaştırma yapar. Karşılaştırılan tüm öğelerin birbirleriyle karşılaştırılabilecek nitelikte olması gerekir. Başka bir deyişle tümünün aynı veri türünde olması (veya karşılaştırmada her zaman en küçük olan null değerini içermesi) gerekir. Aksi takdirde, bir Expression.Error oluşturulur.
Karşılaştırılabilir veri türleri şunlardır:
- Sayı
- Süre
- DateTime
- Metin
- Mantıksal
- Null
| Adı | Açıklama |
|---|---|
| List.Max | Listedeki en büyük değerli öğeyi veya liste boşsa isteğe bağlı varsayılan değeri döndürür. |
| List.MaxN | Listedeki en büyük değerleri döndürür. Döndürülecek değer sayısı veya bir filtreleme koşulu belirtilmelidir. |
| List.Median | Listedeki ortanca değerli öğeyi döndürür. |
| List.Min | Listenin en küçük değerli öğeyi veya liste boşsa isteğe bağlı varsayılan değeri döndürür. |
| List.MinN | Listedeki en küçük değerleri döndürür. Döndürülecek değer sayısı veya bir filtreleme koşulu belirtilebilir. |
| List.Sort | Karşılaştırma ölçütlerini kullanarak sıralanmış bir liste döndürür. |
| List.Percentile | Verilen olasılıklara karşılık gelen bir veya daha fazla örnek yüzdebirlik değeri döndürür. |
Ortalamalar
Bu işlevler Sayı, Tarih/Saat ve Süre içeren homojen listelerle çalışır.
| Adı | Açıklama |
|---|---|
| List.Average | Listenin ortalama değerini listedeki değerlerin türünde döndürür. |
| List.Mode | Listede en sık geçen öğeyi döndürür. |
| List.Modes | Aynı en yüksek sıklık değerine sahip olan tüm öğeleri döndürür. |
| List.StandardDeviation | Değer listesinden standart sapmayı döndürür. List.StandardDeviation örnek tabanlı bir tahmin gerçekleştirir. Sonuç, sayılar için sayı, Tarih arih/Saat ve Süre değerleri için süredir. |
Toplama
Bu işlevler Sayı veya Süre içeren homojen listelerle çalışır.
| Adı | Açıklama |
|---|---|
| List.Sum | Listenin toplamını döndürür. |
Sayısal
Bu işlevler yalnızca sayılarla çalışır.
| Adı | Açıklama |
|---|---|
| List.Covariance | İki listenin kovaryansını sayı olarak döndürür. |
| List.Product | Bir sayı listesinin çarpımını döndürür. |
Oluşturucular
Bu işlevler, değer listesi oluşturur.
| Adı | Açıklama |
|---|---|
| List.Dates | Başlangıçtan başlayıp her değere artış değerini ekleyerek boyut sayısından tarih değeri listesini döndürür. |
| List.DateTimes | Başlangıçtan başlayıp her değere artış değerini ekleyerek boyut sayısından tarih saat değeri listesini döndürür. |
| List.DateTimeZones | Başlangıçtan başlayıp her değere artış değerini ekleyerek boyut sayısından tarih saat dilimi değeri listesini döndürür. |
| List.Durations | Başlangıçtan başlayıp her değere artış değerini ekleyerek boyut sayısından süre değeri listesini döndürür. |
| List.Generate | Değer işlevinden, koşul işlevinden, takip eden işlevden ve isteğe bağlı değer dönüştürme işlevinden liste oluşturur. |
| List.Numbers | Başlangıçtan başlayıp artış değerini ekleyerek boyut sayısından sayı listesini döndürür. Artış için varsayılan olarak 1 değeri kullanılır. |
| List.Random | İsteğe bağlı çekirdek parametresiyle rastgele sayı listesi döndürür. |
| List.Times | Başlangıçtan başlayarak boyut sayısından tarih değeri listesini döndürür. |
Parametre değerleri
Oluşum belirtimi
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
Sıralama düzeni
- Order.Ascending = 0;
- Order.Descending = 1;
Denklem ölçütleri
Liste değerleri için denklem ölçütleri şunlardan biri olarak belirtilebilir:
- Aşağıdakilerden biri olan bir işlev değeri:
- Eşitlik ölçütlerini uygulamak için listedeki değeri belirleyen bir anahtar seçici.
- Uygulanacak karşılaştırma türünü belirtmek için kullanılan bir karşılaştırıcı işlevi. Yerleşik karşılaştırıcı işlevleri belirtilebilir; Karşılaştırıcı işlevleri'ne gidin.
- Şu değerleri içeren bir liste değeri:
- Tam olarak iki öğe.
- İlk öğe, yukarıda belirtilen anahtar seçicidir.
- İkinci öğe ise yukarıda belirtilen karşılaştırıcıdır.
Daha fazla bilgi ve örnek için List.Distinct'a gidin.
Karşılaştırma ölçütleri
Karşılaştırma ölçütü aşağıdaki değerlerden biriyle belirtilebilir:
- Sıralama düzeni belirtmek için bir sayı değeri. Daha fazla bilgi için Sıralama düzeni'ne gidin.
- Sıralama için kullanılacak bir anahtarı hesaplamak için tek bir bağımsız değişkenin işlevi kullanılabilir.
- Hem anahtar seçmek hem de sıralamayı denetlemek için karşılaştırma ölçütleri, anahtarı ve sıralamayı içeren bir liste olabilir.
- Karşılaştırmayı tamamen denetlemek için, sol ve sağ girişler arasındaki ilişki göz önüne alındığında -1, 0 veya 1 döndüren iki bağımsız değişkenin bir işlevi kullanılabilir. Value.Compare , bu mantığa temsilci seçmek için kullanılabilecek bir yöntemdir.
Daha fazla bilgi ve örnek için List.Sort'a gidin.
Değiştirme işlemleri
Değiştirme işlemleri bir liste değeri tarafından belirtilir. Bu listenin her öğesi şu şekilde olmalıdır:
- Tam olarak iki öğeden oluşan bir liste değeri.
- İlk öğe, listedeki değiştirilecek eski değerdir.
- İkinci öğe, listedeki eski değerin tüm oluşumlarının yerini alması gereken yeni değerdir.