Funkcje listy
Te funkcje tworzą wartości list i manipulują nimi.
Informacja
| Nazwa | Opis |
|---|---|
| List.Count | Zwraca liczbę elementów na liście. |
| List.IsEmpty | Zwraca true, jeśli lista jest pusta. |
| List.NonNullCount | Zwraca liczbę elementów innych niż null na liście. |
Selekcja
| Nazwa | Opis |
|---|---|
| List.Alternate | Zwraca listę składającą się z elementów znajdujących się na nieparzystych pozycjach w liście. |
| List.Buffer | Buforuje listę. |
| List.Distinct | Zwraca listę wartości z usuniętymi duplikatami. |
| List.FindText | Zwraca listę wartości (w tym pól rekordów), które zawierają określony tekst. |
| List.First | Zwraca pierwszą wartość listy lub określoną wartość domyślną, jeśli jest pusta. |
| List.FirstN | Zwraca pierwszy zestaw elementów na liście, określając liczbę elementów do zwrócenia lub warunek kwalifikujący. |
| List.InsertRange | Wstawia wartości na liście pod danym indeksem. |
| List.IsDistinct | Wskazuje, czy na liście znajdują się duplikaty. |
| List.Last | Zwraca ostatnią wartość listy lub określoną wartość domyślną, jeśli jest pusta. |
| List.LastN | Zwraca ostatnią wartość na liście. Opcjonalnie można określić liczbę wartości, które mają zostać zwrócone lub warunek kwalifikujący. |
| List.MatchesAll | Zwraca true, jeśli funkcja warunku jest spełniona przez wszystkie wartości na liście. |
| List.MatchesAny | Zwraca true, jeśli funkcja warunku jest spełniona przez dowolną wartość. |
| List.Positions | Zwraca listę przesunięć dla danych wejściowych. |
| List.Range | Zwraca podzbiór listy, zaczynając od określonego przesunięcia. |
| List.Select | Zwraca listę wartości, które są zgodne z warunkiem. |
| List.Single | Zwraca jeden element listy dla listy o długości równej jednej, w przeciwnym razie wywołuje wyjątek. |
| List.SingleOrDefault | Zwraca jeden element listy dla listy o długości jednej i wartość domyślną dla pustej listy. |
| List.Skip | Zwraca listę, która pomija określoną liczbę elementów na początku listy. |
Funkcje przekształcania
| Nazwa | Opis |
|---|---|
| List.Accumulate | AAccumulatuje wartość podsumowania z elementów na liście. |
| List.Combine | Tworzy jedną listę poprzez połączenie wielu list. |
| List.ConformToPageReader | Ta funkcja jest przeznaczona tylko do użytku wewnętrznego. |
| List.RemoveFirstN | Zwraca listę, która pomija określoną liczbę elementów na początku listy. |
| List.RemoveItems | Usuwa elementy z pierwszej listy, które znajdują się na drugiej liście. |
| List.RemoveLastN | Zwraca listę, która usuwa określoną liczbę elementów z końca listy. |
| List.RemoveMatchingItems | Usuwa wszystkie wystąpienia wartości wejściowych. |
| List.RemoveNulls | Usuwa wszystkie null wartości z określonej listy. |
| List.RemoveRange | Usuwa liczbę wartości rozpoczynających się od określonej pozycji. |
| List.Repeat | Zwraca listę składającą się z count powtórzeń oryginalnej listy. |
| List.ReplaceMatchingItems | Zastępuje wystąpienia istniejących wartości na liście nowymi wartościami, które pasują do warunku. |
| List.ReplaceRange | Zamienia count liczbę wartości rozpoczynających się od position wartościami zastępczymi. |
| List.ReplaceValue | Wyszukuje listę dla określonej wartości i zastępuje ją. |
| List.Reverse | Odwraca kolejność wartości na liście. |
| List.Split | Dzieli określoną listę na listę list przy użyciu podanego rozmiaru strony. |
| List.Transform | Zwraca nową listę wartości obliczonych z tej listy. |
| List.TransformMany | Zwraca listę, której elementy są przekształcane z listy danych wejściowych przy użyciu określonych funkcji. |
| List.Zip | Zwraca listę list, łącząc elementy znajdujące się na tych samych pozycjach na wielu listach. |
Funkcje członkostwa
Ponieważ wszystkie wartości można przetestować pod kątem równości, te funkcje mogą działać na listach heterogenicznych.
| Nazwa | Opis |
|---|---|
| List.AllTrue | Zwraca true, jeśli wszystkie wyrażenia są prawdziwe. |
| List.AnyTrue | Zwraca wartość true, jeśli dowolne wyrażenie ma wartość true. |
| List.Contains | Wskazuje, czy lista zawiera wartość. |
| List.ContainsAll | Wskazuje, gdzie lista zawiera wszystkie wartości na innej liście. |
| List.ContainsAny | Wskazuje, gdzie lista zawiera dowolną z wartości na innej liście. |
| List.PositionOf | Zwraca przesunięcia wartości na liście. |
| List.PositionOfAny | Zwraca pierwsze przesunięcie wartości na liście. |
Ustawianie operacji
| Nazwa | Opis |
|---|---|
| List.Difference | Zwraca różnicę dwóch danych list. |
| List.Intersect | Zwraca przecięcie wartości listy znalezionych w danych wejściowych. |
| List.Union | Zwraca związek wartości listy znalezionych w danych wejściowych. |
Zamawianie
Funkcje porządkowania wykonują porównania. Wszystkie porównywane wartości muszą być porównywalne ze sobą. Oznacza to, że wszystkie muszą pochodzić z tego samego typu danych (lub zawierają wartość null, która zawsze porównuje najmniejsze). W przeciwnym razie zostanie zgłoszony Expression.Error.
Porównywalne typy danych obejmują:
- Liczba
- Czas trwania
- Data i czas
- Tekst
- Logiczny
- Zero
| Nazwa | Opis |
|---|---|
| List.Max | Zwraca wartość maksymalną lub wartość domyślną dla pustej listy. |
| List.MaxN | Zwraca wartości maksymalne na liście. Należy określić liczbę wartości do zwrócenia lub warunek filtrowania. |
| List.Median | Zwraca wartość mediany na liście. |
| List.Min | Zwraca wartość minimalną lub wartość domyślną pustej listy. |
| List.MinN | Zwraca wartości minimalne na liście. Można określić liczbę wartości do zwrócenia lub warunek filtrowania. |
| List.Sort | Sortuje listę danych zgodnie z określonymi kryteriami. |
| List.Percentile | Zwraca co najmniej jeden percentyl próbki odpowiadający danym prawdopodobieństwu. |
Średnie
Te funkcje działają na jednorodnych listach liczb, dat i czasów.
| Nazwa | Opis |
|---|---|
| List.Average | Zwraca średnią wartości. Działa z wartościami liczb, daty, daty/godziny, strefy czasowej i czasu trwania. |
| List.Mode | Zwraca najczęściej spotykaną wartość na liście. |
| List.Modes | Zwraca listę najczęściej występujących wartości na liście. |
| List.StandardDeviation | Zwraca szacowanie odchylenia standardowego na podstawie próbki. Ta funkcja wykonuje oszacowanie oparte na próbie. Wynikiem jest liczba dla liczb oraz czas trwania dla DateTimes i Durations. |
Dodatek
Te funkcje działają na jednorodnych listach liczb lub czasów trwania.
| Nazwa | Opis |
|---|---|
| List.Sum | Zwraca sumę elementów na liście. |
Liczby
Te funkcje działają tylko z liczbami.
| Nazwa | Opis |
|---|---|
| List.Covariance | Zwraca kowariancję między dwiema listami liczb. |
| List.Product | Zwraca iloczyn liczb na liście. |
Generatory
Te funkcje generują listę wartości.
| Nazwa | Opis |
|---|---|
| List.Dates | Generuje listę wartości date, biorąc pod uwagę początkową wartość, liczbę i wartość czasu trwania przyrostowego. |
| List.DateTimes | Generuje listę wartości datetime, biorąc pod uwagę początkową wartość, liczbę i wartość czasu trwania przyrostowego. |
| List.DateTimeZones | Generuje listę wartości datetimezone, biorąc pod uwagę początkową wartość, liczbę i wartość czasu trwania przyrostowego. |
| List.Durations | Generuje listę wartości duration, biorąc pod uwagę początkową wartość, liczbę i wartość czasu trwania przyrostowego. |
| List.Generate | Generuje listę wartości. |
| List.Numbers | Zwraca listę liczb z wartością początkową, liczbą i opcjonalną wartością przyrostową. |
| List.Random | Zwraca listę liczb losowych. |
| List.Times | Generuje listę wartości time, biorąc pod uwagę początkową wartość, liczbę i wartość czasu trwania przyrostowego. |
Wartości parametrów
Specyfikacja wystąpienia
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
Kolejność sortowania
- Order.Ascending = 0;
- Order.Descending = 1;
Kryteria równania
Kryteria równania dla wartości listy można określić jako:
- Wartość funkcji, która jest jedną z następujących wartości:
- Selektor klucza, który określa wartość na liście w celu zastosowania kryteriów równości.
- Funkcja porównująca, która służy do określania rodzaju porównania do zastosowania. Można określić wbudowane funkcje porównujące — przejdź do funkcji porównujących.
- Wartość z listy, która zawiera:
- Dokładnie dwa elementy.
- Pierwszym elementem jest selektor kluczy, jak określono powyżej.
- Drugi element jest elementem porównującym, jak określono powyżej.
Aby uzyskać więcej informacji i przykładów, przejdź do List.Distinct.
Kryteria porównania
Kryterium porównania można podać jako jedną z następujących wartości:
- Wartość liczbowa określająca kolejność sortowania. Aby uzyskać więcej informacji, przejdź do kolejność sortowania.
- Aby obliczyć klucz używany do sortowania, można użyć funkcji jednego argumentu.
- Aby wybrać zarówno klucz, jak i kolejność sterowania, kryterium porównania może być lista zawierająca klucz i kolejność.
- Aby całkowicie kontrolować porównanie, można użyć funkcji dwóch argumentów, która zwraca wartość -1, 0 lub 1, biorąc pod uwagę relację między danymi wejściowymi po lewej i prawej stronie. Value.Compare to metoda, która może służyć do delegowania tej logiki.
Aby uzyskać więcej informacji i przykładów, przejdź do List.Sort.
Operacje zastępcze
Operacje zastępcze są określane przez listę wartości. Każdy element tej listy musi być:
- Wartość listy dokładnie dwóch elementów.
- Pierwszy element to stara wartość na liście, która ma zostać zamieniona.
- Drugi element to nowa wartość, która powinna zastąpić wszystkie wystąpienia starej wartości na liście.