Funkcje listy
Te funkcje tworzą wartości list i manipulują nimi.
Informacja
| Nazwa | Opis |
|---|---|
| List.Count | Zwraca liczbę elementów na liście. |
| List.NonNullCount | Zwraca liczbę elementów na liście z wyłączeniem wartości null |
| List.IsEmpty | Zwraca, czy lista jest pusta. |
Selekcja
| Nazwa | Opis |
|---|---|
| List.Alternate | Zwraca listę z elementami naprzemiennymi z oryginalnej listy na podstawie liczby, opcjonalnego interwału powtórzeń i opcjonalnego przesunięcia. |
| List.Buffer | Buforuje listę w pamięci. Wynikiem tego wywołania jest stabilna lista, co oznacza, że będzie miała liczbę determinimiczną i kolejność elementów. |
| List.Distinct | Filtruje listę w dół, usuwając duplikaty. Można określić opcjonalną wartość kryteriów równania w celu kontrolowania porównania równości. Wybierana jest pierwsza wartość z każdej grupy równości. |
| List.FindText | Wyszukuje listę wartości, w tym pól rekordów, dla wartości tekstowej. |
| List.First | Zwraca pierwszą wartość listy lub określoną wartość domyślną, jeśli jest pusta. Zwraca pierwszy element na liście lub opcjonalną wartość domyślną, jeśli lista jest pusta. Jeśli lista jest pusta i nie określono wartości domyślnej, funkcja zwraca wartość. |
| List.FirstN | Zwraca pierwszy zestaw elementów na liście, określając liczbę elementów do zwrócenia lub warunek kwalifikujący podany przez countOrCondition. |
| List.InsertRange | Wstawia elementy z wartości w danym indeksie na liście danych wejściowych. |
| List.IsDistinct | Zwraca, czy lista jest odrębna. |
| List.Last | Zwraca ostatni zestaw elementów na liście, określając liczbę elementów do zwrócenia lub warunek kwalifikujący podany przez countOrCondition. |
| List.LastN | Zwraca ostatni zestaw elementów na liście, określając liczbę elementów do zwrócenia lub warunek kwalifikujący. |
| List.MatchesAll | Zwraca wartość true, jeśli wszystkie elementy na liście spełniają warunek. |
| List.MatchesAny | Zwraca wartość true, jeśli dowolny element na liście spełnia warunek. |
| List.Positions | Zwraca listę pozycji dla listy danych wejściowych. |
| List.Range | Zwraca określoną liczbę elementów zaczynającą się od danego przesunięcia. |
| List.Select | Wybiera elementy zgodne z warunkiem. |
| List.Single | Zwraca pojedynczy element listy lub zgłasza błąd Expression.Error, jeśli lista zawiera więcej niż jeden element. |
| List.SingleOrDefault | Zwraca pojedynczy element z listy. |
| List.Skip | Pomija pierwszy element listy. Dla pustej listy zwraca pustą listę. Ta funkcja przyjmuje opcjonalny parametr countOrCondition do obsługi pomijania wielu wartości. |
Funkcje przekształcania
| Nazwa | Opis |
|---|---|
| List.Accumulate | Gromadzi rezultat z listy. Począwszy od wartości początkowej, ta funkcja stosuje funkcję sumującą i zwraca wynik końcowy. |
| List.Combine | Łączy listę list w jedną listę. |
| List.ConformToPageReader | Ta funkcja jest przeznaczona tylko do użytku wewnętrznego. |
| List.RemoveRange | Zwraca listę, która usuwa elementy liczbowe rozpoczynające się od przesunięcia. Domyślna liczba to 1. |
| List.RemoveFirstN | Zwraca listę z określoną liczbą elementów usuniętych z listy, zaczynając od pierwszego elementu. Liczba usuniętych elementów zależy od opcjonalnego parametru countOrCondition. |
| List.RemoveItems | Usuwa elementy z list1, które znajdują się w list2, i zwraca nową listę. |
| List.RemoveLastN | Zwraca listę z określoną liczbą elementów usuniętych z listy, zaczynając od ostatniego elementu. Liczba usuniętych elementów zależy od opcjonalnego parametru countOrCondition. |
| List.Repeat | Zwraca listę, która powtarza zawartość listy wejściowej określoną liczbę razy. |
| List.ReplaceRange | Zwraca listę, która zastępuje wartości liczbowe na liście listą replaceWith rozpoczynającą się od indeksu. |
| List.RemoveMatchingItems | Usuwa wszystkie wystąpienia podanych wartości na liście. |
| List.RemoveNulls | Usuwa wartości null z listy. |
| List.ReplaceMatchingItems | Zastępuje wystąpienia istniejących wartości na liście nowymi wartościami przy użyciu podanej equationCriteria. Stare i nowe wartości są dostarczane przez parametry replacements. Można określić opcjonalną wartość kryteriów równania w celu kontrolowania porównań równości. Aby uzyskać szczegółowe informacje na temat operacji wymiany i kryteriów równania, przejdź do Wartości parametrów. |
| List.ReplaceValue | Przeszukuje listę wartości w poszukiwaniu konkretnej wartości i zamienia każde jej wystąpienie na wartość zastępczą. |
| List.Reverse | Zwraca listę, która odwraca kolejność elementów w liście. |
| List.Split | Dzieli określoną listę na listę list przy użyciu podanego rozmiaru strony. |
| List.Transform | Wykonuje funkcję na każdym elemencie na liście i zwraca nową listę. |
| List.TransformMany | Zwraca listę, której elementy są przewidywane z listy danych wejściowych. |
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 wartość true, jeśli wszystkie wyrażenia na liście mają wartość true |
| List.AnyTrue | Zwraca wartość true, jeśli dowolne wyrażenie na liście ma wartość true |
| List.Contains | Zwraca wartość true, jeśli wartość zostanie znaleziona na liście. |
| List.ContainsAll | Zwraca wartość true, jeśli wszystkie elementy w wartościach znajdują się na liście. |
| List.ContainsAny | Zwraca wartość true, jeśli dowolny element w wartościach znajduje się na liście. |
| List.PositionOf | Znajduje pierwsze wystąpienie wartości na liście i zwraca jej pozycję. |
| List.PositionOfAny | Znajduje pierwsze wystąpienie dowolnej wartości w wartościach i zwraca jej pozycję. |
Ustawianie operacji
| Nazwa | Opis |
|---|---|
| List.Difference | Zwraca elementy na liście 1, które nie są wyświetlane na liście 2. Obsługiwane są zduplikowane wartości. |
| List.Intersect | Zwraca listę z listy list i wyznacza wspólne elementy w poszczególnych listach. Obsługiwane są zduplikowane wartości. |
| List.Union | Zwraca listę z list list i łączy elementy z poszczególnych list. Zwrócona lista zawiera wszystkie elementy na wszystkich listach wejściowych. Zduplikowane wartości są dopasowywane w ramach Unii. |
| List.Zip | Zwraca listę list łączących elementy na tych samych pozycjach. |
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 maksymalny element na liście lub opcjonalną wartość domyślną, jeśli lista jest pusta. |
| List.MaxN | Zwraca maksymalne wartości na liście. Należy określić liczbę wartości do zwrócenia lub warunek filtrowania. |
| List.Median | Zwraca medianę elementu z listy. |
| List.Min | Zwraca minimalny element na liście lub opcjonalną wartość domyślną, jeśli lista jest pusta. |
| List.MinN | Zwraca minimalne wartości na liście. Można określić liczbę wartości do zwrócenia lub warunek filtrowania. |
| List.Sort | Zwraca posortowaną listę przy użyciu kryterium porównania. |
| 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ść z listy zgodnie z typem danych wartości na liście. |
| List.Mode | Zwraca element, który jest najczęściej wyświetlany na liście. |
| List.Modes | Zwraca wszystkie elementy, które są wyświetlane z taką samą maksymalną częstotliwością. |
| List.StandardDeviation | Zwraca odchylenie standardowe z listy wartości. List.StandardDeviation wykonuje szacowanie na podstawie próbki. 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ę z listy. |
Liczby
Te funkcje działają tylko z liczbami.
| Nazwa | Opis |
|---|---|
| List.Covariance | Zwraca kowariancję z dwóch list jako liczbę. |
| List.Product | Zwraca produkt z listy liczb. |
Generatory
Te funkcje generują listę wartości.
| Nazwa | Opis |
|---|---|
| List.Dates | Zwraca listę wartości dat z licznika rozmiaru, zaczynając od początku i dodaje przyrost do każdej wartości. |
| List.DateTimes | Zwraca listę wartości daty/godziny o określonej liczbie elementów, rozpoczynając od daty początkowej i dodaje przyrost do każdej wartości. |
| List.DateTimeZones | Zwraca listę wartości daty/godziny/strefy czasowej z liczby rozmiarów, począwszy od początku i dodaje przyrost do każdej wartości. |
| List.Durations | Zwraca listę wartości czasu trwania dla podanej liczby elementów, zaczynając od określonego punktu startowego i dodając przyrost do każdej wartości. |
| List.Generate | Generuje listę wartości. |
| List.Numbers | Zwraca listę liczb o zadanej wielkości, zaczynając od wartości początkowej, i dodaje inkrement. Wartość domyślna przyrostu to 1. |
| List.Random | Zwraca listę liczb losowych o określonej liczbie elementów, z opcjonalnym parametrem inicjującym. |
| List.Times | Zwraca listę wartości czasu liczby rozmiarów, począwszy od początku. |
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.