Aracılığıyla paylaş

Liste işlevleri

  • Makale

Bu işlevler liste değerlerini oluşturur ve işler.

Bilgi

İsim Açıklama
List.Count Listedeki öğelerin sayısını döndürür.
List.IsEmpty Liste boşsa true döndürür.
List.NonNullCount Listedeki null olmayan öğelerin sayısını döndürür.

Seleksiyon

İsim Açıklama
List.Alternate Listedeki tüm tek numaralı uzaklık öğelerinden oluşan bir liste döndürür.
List.Buffer Listeyi arabelleğe alır.
List.Distinct Yinelenenlerin kaldırıldığı değerlerin listesini döndürür.
List.FindText Belirtilen metni içeren değerlerin (kayıt alanları dahil) listesini döndürür.
List.First Listenin ilk değerini veya boşsa belirtilen varsayılan değeri döndürür.
List.FirstN Döndürülecek öğe sayısını veya uygun bir koşulu belirterek listedeki ilk öğe kümesini döndürür.
List.InsertRange Verilen dizindeki bir listeye değer ekler.
List.IsDistinct Listede yinelenenler olup olmadığını gösterir.
List.Last Listenin son değerini veya boşsa belirtilen varsayılan değeri döndürür.
List.LastN Listedeki son değeri döndürür. İsteğe bağlı olarak döndürülecek değer sayısını veya uygun bir koşulu belirtebilir.
List.MatchesAll Koşul işlevi listedeki tüm değerlerden memnunsa true döndürür.
List.MatchesAny Koşul işlevi herhangi bir değer ile sağlanıyorsa true döndürür.
List.Positions Giriş için uzaklıkların listesini döndürür.
List.Range Uzaklıkta başlayan listenin bir alt kümesini döndürür.
List.Select Koşulla eşleşen değerlerin listesini döndürür.
List.Single Uzunluğu bir olan bir liste için tek liste öğesini döndürür, aksi takdirde bir istisna fırlatır.
List.SingleOrDefault Uzunluğu bir olan bir liste için liste öğesini ve boş bir liste için varsayılan değeri döndürür.
List.Skip Listenin başında belirtilen öğe sayısını atlayan bir liste döndürür.

Dönüştürme işlevleri

İsim Açıklama
List.Accumulate AAccumulates listedeki öğelerden bir toplam değer oluşturur.
List.Combine Birden çok listeyi birleştirerek tek bir liste döndürür.
List.ConformToPageReader Bu işlev yalnızca iç kullanıma yöneliktir.
List.RemoveFirstN Listenin başında belirtilen öğe sayısını atlayan bir liste döndürür.
List.RemoveItems İkinci listede bulunan ilk listeden öğeleri kaldırır.
List.RemoveLastN Belirtilen öğe sayısını listenin sonundan kaldıran bir liste döndürür.
List.RemoveMatchingItems Giriş değerlerinin tüm geçişlerini kaldırır.
List.RemoveNulls Belirtilen listeden tüm null değerlerini kaldırır.
List.RemoveRange Belirtilen konumdan başlayarak belirtilen sayıda değeri kaldırır.
List.Repeat Özgün listenin count kez tekrarlanmasıyla oluşturulan bir liste döndürür.
List.ReplaceMatchingItems Listedeki mevcut değerlerin oluşumlarını koşulla eşleşen yeni değerlerle değiştirir.
List.ReplaceRange position'den başlayarak count adet değeri, yer değiştirme değerleriyle değiştirir.
List.ReplaceValue Belirtilen değerin listesini arar ve değiştirir.
List.Reverse Listedeki değerlerin sırasını tersine çevirir.
List.Split Belirtilen sayfa boyutunu kullanarak belirtilen listeyi liste listesine böler.
List.Transform Bu listeden hesaplanan değerlerin yeni bir listesini döndürür.
List.TransformMany Öğeleri belirtilen işlevler kullanılarak giriş listesinden dönüştürülen bir liste döndürür.
List.Zip Birden çok listede aynı konumdaki öğeleri birleştirerek liste listesini döndürür.

Üyelik işlevleri

Tüm değerler eşitlik açısından test edilebildiğinden, bu işlevler heterojen listeler üzerinde çalışabilir.

İsim Açıklama
List.AllTrue Tüm ifadeler doğruysa true döndürür.
List.AnyTrue Hangi ifade doğruysa doğru döndürür.
List.Contains Listenin değeri içerip içermediğini gösterir.
List.ContainsAll Bir listenin başka bir listedeki tüm değerleri nerede içerdiğini gösterir.
List.ContainsAny Bir listenin başka bir listedeki değerlerden herhangi birini nerede içerdiğini gösterir.
List.PositionOf Listedeki bir değerin uzaklıklarını döndürür.
List.PositionOfAny Listedeki bir değerin ilk uzaklığını döndürür.

İşlemleri ayarlama

İsim Açıklama
List.Difference Verilen iki liste arasındaki farkı döndürür.
List.Intersect Girişte bulunan liste değerlerinin kesişimini döndürür.
List.Union Girişte bulunan liste değerlerinin birleşimini döndürür.

Sipariş

Sıralama işlevleri karşılaştırmalar yapar. Karşılaştırılan tüm değerler birbiriyle karşılaştırılabilir olmalıdır. Bu, hepsinin aynı veri türünden gelmesi gerektiği (veya her zaman en küçük olan null değerini içermesi) gerektiği anlamına gelir. Aksi takdirde, bir Expression.Error atılır.

Karşılaştırılabilir veri türleri şunlardır:

  • Sayı
  • Süre
  • TarihSaat
  • Metin
  • Mantıklı
  • Sıfır
İsim Açıklama
List.Max Boş bir liste için en yüksek değeri veya 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ğeri döndürür.
List.Min Boş bir liste için en düşük değeri veya varsayılan değeri döndürür.
List.MinN Listedeki en düşük değerleri döndürür. Döndürülecek değer sayısı veya filtreleme koşulu belirtilebilir.
List.Sort Veri listesini belirtilen ölçütlere göre sıralar.
List.Percentile Verilen olasılıklara karşılık gelen bir veya daha fazla örnek yüzdelik dilimini döndürür.

Ortalamalar

Bu işlevler Numbers, DateTimes ve Durations gibi homojen listeler üzerinde çalışır.

İsim Açıklama
List.Average Değerlerin ortalamasını döndürür. Sayı, tarih, tarih saat, tarih saat dilimi ve süre değerleriyle çalışır.
List.Mode Listedeki en sık kullanılan değeri döndürür.
List.Modes Listedeki en sık kullanılan değerlerin listesini döndürür.
List.StandardDeviation Standart sapmanın örnek tabanlı bir tahminini döndürür. Bu işlev örnek tabanlı bir tahmin gerçekleştirir. Sonuç, sayılar için bir sayı, TarihSaatler ve Süreler için bir süre olur.

İlave

Bu işlevler, Sayı veya Süreler'in homojen listeleri üzerinde çalışır.

İsim Açıklama
List.Sum Listedeki öğelerin toplamını döndürür.

Sayısallar

Bu işlevler yalnızca sayılar üzerinde çalışır.

İsim Açıklama
List.Covariance İki sayı listesi arasındaki kovaryansı döndürür.
List.Product Listedeki sayıların çarpımını döndürür.

Jeneratör

Bu işlevler değerlerin listesini oluşturur.

İsim Açıklama
List.Dates İlk değer, sayı ve artımlı süre değeri verilen date değerlerinin listesini oluşturur.
List.DateTimes İlk değer, sayı ve artımlı süre değeri verilen datetime değerlerinin listesini oluşturur.
List.DateTimeZones İlk değer, sayı ve artımlı süre değeri verilen datetimezone değerlerinin listesini oluşturur.
List.Durations İlk değer, sayı ve artımlı süre değeri verilen duration değerlerinin listesini oluşturur.
List.Generate Değerlerin listesini oluşturur.
List.Numbers Başlangıç değeri, sayı ve isteğe bağlı artış değeri verilen sayıların listesini döndürür.
List.Random Rastgele sayıların listesini döndürür.
List.Times İlk değer, sayı ve artımlı süre değeri verilen time değerlerinin listesini oluşturur.

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ırma işlevleri belirlenebilir—Karşılaştırıcı işlevleribölümüne gidin.
  • Şu değerlere sahip bir liste değeri:
    • Tam olarak iki öğe.
    • İlk öğe, yukarıda belirtilen anahtar seçicidir.
    • İkinci öğe, yukarıda belirtildiği gibi bir karşılaştırıcıdır.

Daha fazla bilgi ve örnek için List.Distinctbölümüne gidin.

Karşılaştırma ölçütleri

Karşılaştırma ölçütü aşağıdaki değerlerden biri olarak sağlanabilir:

  • Sıralama düzeni belirtmek için bir sayı değeri. Daha fazla bilgi için Sıralama düzeni'ye 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 hem de denetim sırası seçmek için karşılaştırma ölçütü, anahtarı ve sırayı 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ığı temsilci olarak atamak için kullanılabilecek bir yöntemdir.

Daha fazla bilgi ve örnek için List.Sortbölümüne 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.