Liste işlevleri

  • Makale

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

Bilgiler

Ad Tanım
List.Count Listedeki öğelerin sayısını döndürür.
List.NonNullCount Null değerler dışında bir listedeki öğe sayısını verir
List.IsEmpty Listenin boş olup olmadığını döndürür.

Seçim

Ad Tanım
List.Alternate Bir sayı, isteğe bağlı repeatInterval ve isteğe bağlı bir uzaklık temelinde özgün listeden alternatif öğeler içeren bir liste döndürür.
List.Buffer Listeyi bellekte arabelleğe alır. Bu çağrının sonucu kararlı bir listedir; bu da determinimik bir sayıya ve öğelerin sırasına sahip olacağı anlamına gelir.
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 grubundan ilk değer seçilir.
List.FindText Kayıt alanları da dahil olmak üzere bir değer listesinde metin değeri arar.
List.First Listenin ilk değerini veya boşsa belirtilen varsayılan değeri döndürür. Listedeki ilk öğeyi veya liste boşsa isteğe bağlı varsayılan değeri döndürür. Liste boşsa ve varsayılan değer belirtilmezse işlev döndürü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 dizindeki değerlerden öğe ekler.
List.IsDistinct Bir listenin ayrı 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ını veya uygun bir koşulu belirterek listedeki son öğe kümesini döndürür.
List.MatchesAll Listedeki tüm öğeler bir koşulu karşılıyorsa true döndürür.
List.MatchesAny Listedeki herhangi bir öğe bir koşulu karşılıyorsa true döndürür.
List.Positions Giriş listesi için konumların listesini döndürür.
List.Range Uzaklıkta başlayan bir sayı öğesi 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. Boş bir liste verilip boş bir liste döndürülüyor. 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 Tanım
List.Accumulate Listeden bir sonuç biriktirir. İlk değer çekirdeğinden başlayarak bu işlev biriktirici işlevini uygular ve nihai sonucu döndürür.
List.Combine Liste listesini tek bir listede birleştirir.
List.ConformToPageReader Bu işlev yalnızca iç kullanıma yöneliktir.
List.RemoveRange Uzaklıkta başlayan sayı öğelerini kaldıran bir liste döndürür. Varsayılan sayı 1'dir.
List.RemoveFirstN İlk öğeden başlayarak listeden belirtilen sayıda öğenin kaldırıldığı bir liste döndürür. Kaldırılan öğe sayısı isteğe bağlı countOrCondition parametreye bağlıdır.
List.RemoveItems içinde list2bulunan öğ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ıldığı bir liste döndürür. Kaldırılan öğe sayısı isteğe bağlı countOrCondition parametreye bağlıdır.
List.Repeat Giriş listesi sayısı sürelerinin içeriğini yineleyen bir liste döndürür.
List.ReplaceRange Listedeki sayı değerlerini dizinden başlayan bir replaceWith listeyle değiştiren bir liste döndürür.
List.RemoveMatchingItems Listedeki verilen değerlerin tüm oluşumlarını kaldırır.
List.RemoveNulls Bir listeden 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 denklem ölçüt değeri belirtilebilir. Değiştirme işlemlerinin ve denklem ölçütlerinin ayrıntıları için Parametre değerleri'ne gidin.
List.ReplaceValue Değer için bir değer listesi arar ve her oluşumu değiştirme değeriyle değiştirir.
List.Reverse Listedeki öğeleri tersine çeviren bir liste döndürür.
List.Split Belirtilen sayfa boyutunu kullanarak belirtilen listeyi liste listesine böler.
List.Transform listedeki her öğede işlevini gerçekleştirir 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ğerler eşitlik açısından test edilebildiğinden, bu işlevler heterojen listeler üzerinde çalışabilir.

Ad Tanım
List.AllTrue Listedeki tüm ifadeler true ise true döndürür
List.AnyTrue Listedeki herhangi bir ifade true ise true döndürür
List.Contains Listede bir değer bulunursa true döndürür.
List.ContainsAll Değerlerdeki tüm öğeler bir listede bulunursa true döndürür.
List.ContainsAny Değerlerdeki herhangi bir öğe listede bulunursa true döndürür.
List.PositionOf Bir değerin listedeki ilk oluşumunu bulur ve konumunu döndürür.
List.PositionOfAny Değerlerdeki herhangi bir değerin ilk oluşumunu bulur ve konumunu döndürür.

İşlemleri ayarlama

Ad Tanım
List.Difference Liste 1'de liste 2'de görünmeyen öğeleri döndürür. Yinelenen değerler desteklenir.
List.Intersect Liste listesinden bir liste döndürür ve tek tek listelerdeki ortak öğelerle kesişer. Yinelenen değerler desteklenir.
List.Union Liste listesinden bir liste döndürür ve tek tek listelerdeki öğeleri birler. Döndürülen liste, herhangi bir giriş listesindeki tüm öğeleri içerir. Yinelenen değerler Birleşim'in bir parçası olarak eşleştirilir.
List.zip Aynı konumdaki öğeleri birleştiren listelerin listesini döndürür.

Sıralama

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 oluşturulur.

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

  • Numara
  • Süre
  • DateTime
  • Metin
  • Mantıksal
  • Boş
Ad Tanım
List.Max Listedeki en yüksek öğeyi veya liste boşsa isteğe bağlı varsayılan değeri döndürür.
List.MaxN Listedeki en yüksek değerleri döndürür. Döndürülecek değer sayısı veya bir filtreleme koşulu belirtilmelidir.
List.Median Listeden ortanca öğeyi döndürür.
List.Min Listedeki en küçük öğeyi veya liste boşsa isteğe bağlı 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 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 Numbers, DateTimes ve Durations gibi homojen listeler üzerinde çalışır.

Ad Tanım
List.Average Listedeki değerlerin veri türündeki bir listeden ortalama bir değer döndürür.
List.Mode Listede en yaygın olarak görünen bir öğeyi döndürür.
List.Modes Aynı maksimum sıklıkta görünen tüm öğeleri döndürür.
List.StandardDeviation Değer listesinden standart sapması döndürür. List.StandardDeviation örnek tabanlı bir tahmin gerçekleştirir. Sonuç, sayılar için bir sayı, DateTimes ve Süreler için bir süredir.

Ekleme

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

Ad Tanım
List.Sum Listedeki toplamı döndürür.

Sayısal veriler

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

Ad Tanım
List.Covariance İki listeden kovaryansı sayı olarak döndürür.
List.Product Bir sayı listesinden ürünü döndürür.

Jeneratör

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

Ad Tanım
List.Dates Başlangıçtan başlayarak boyut sayısındaki tarih değerlerinin listesini döndürür ve her değere bir artış ekler.
List.DateTimes Başlangıçtan başlayarak boyut sayısındaki tarih saat değerlerinin listesini döndürür ve her değere bir artış ekler.
List.DateTimeZones Başlangıçtan başlayarak boyut sayısındaki datetimezone değerlerinin listesini döndürür ve her değere bir artış ekler.
List.Durations Başlangıçtan başlayarak boyut sayısındaki süre değerlerinin listesini döndürür ve her değere bir artış ekler.
List.Generate Değerlerin listesini oluşturur.
List.Numbers Başlangıçtan başlayarak boyut sayısındaki sayıların listesini döndürür ve bir artış ekler. Artış varsayılan olarak 1'e ayarlı.
List.Random İsteğe bağlı bir çekirdek parametresiyle rastgele sayıları sayma listesini döndürür.
List.Times Başlangıçtan başlayarak boyut sayısının zaman değerlerinin 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ğ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.Distinct'a 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'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 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.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.