Liste işlevleri
Bu işlevler liste değerlerini oluşturur ve işler.
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. |
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 countOrCondition sağ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 countOrCondition sağ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. |
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 list2 bulunan öğ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. |
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. |
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 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. |
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. |
Bu işlevler, Sayı veya Süreler'in homojen listeleri üzerinde çalışır.
Ad | Tanım |
---|---|
List.Sum | Listedeki toplamı döndürür. |
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. |
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. |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Ascending = 0;
- Order.Descending = 1;
Liste değerleri için denklem ölçütleri şunlardan biri olarak belirtilebilir:
- Aşağıdakilerden biri olan bir işlev değeri:
- Ş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çü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 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.