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

Sıralama düzeni

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.