Lista funkcji
Te funkcje tworzą wartości list i manipulują nimi.
Nazwa/nazwisko | 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. |
Nazwa/nazwisko | opis |
---|---|
List.Alternate | Zwraca listę z elementami alternatywnymi z oryginalnej listy na podstawie liczby, opcjonalnego powtórzeniaInterval 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, które mają zostać zwrócone, lub warunek kwalifikujący dostarczony przez countOrCondition program . |
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, które mają zostać zwrócone, lub warunek kwalifikujący dostarczony przez countOrCondition program . |
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.Position | Zwraca listę pozycji dla listy danych wejściowych. |
List.Range | Zwraca elementy liczbowe rozpoczynające się od 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. Biorąc pod uwagę pustą listę, zwraca pustą listę. Ta funkcja przyjmuje opcjonalny parametr countOrCondition do obsługi pomijania wielu wartości. |
Nazwa/nazwisko | opis |
---|---|
List.Accumulate | Gromadzi wynik z listy. Począwszy od początkowego inicjatora wartości, ta funkcja stosuje funkcję akumulatorową i zwraca wynik końcowy. |
List.Combine | Scala listę list z 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 countOrCondition parametru. |
List.RemoveItems | Usuwa elementy znajdujące list1 się w obiekcie 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 countOrCondition parametru. |
List.Repeat | Zwraca listę, która powtarza zawartość liczby godzin listy wejściowej. |
List.ReplaceRange | Zwraca listę, która zastępuje wartości liczbowe na liście listą zaczynającą replaceWith 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 podanego equationCriteria elementu . Parametry udostępniają replacements stare i nowe wartości. Można określić opcjonalną wartość kryteriów równania w celu kontrolowania porównań równości. Aby uzyskać szczegółowe informacje o operacjach zastępczych i kryteriach równania, przejdź do pozycji Wartości parametrów. |
List.ReplaceValue | Wyszukuje listę wartości dla wartości i zamienia każde wystąpienie na wartość zastępczą. |
List.Reverse | Zwraca listę, która odwraca elementy na liście. |
List.Split | Dzieli określoną listę na listę list przy użyciu określonego 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. |
Ponieważ wszystkie wartości można przetestować pod kątem równości, te funkcje mogą działać na listach heterogenicznych.
Nazwa/nazwisko | 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 swoją pozycję. |
Nazwa/nazwisko | 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 przecina wspólne elementy na poszczególnych listach. Obsługiwane są zduplikowane wartości. |
List.Union | Zwraca listę z listy list i związków elementów na poszczególnych listach. 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 w tej samej pozycji. |
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 zgłaszany jest element Expression.Error
.
Porównywalne typy danych obejmują:
- Numer
- Czas trwania
- Data/godzina
- Tekst
- Wartość logiczna
- Null (zero)
Nazwa/nazwisko | 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.Percentyl | Zwraca co najmniej jeden percentyl próbki odpowiadający danym prawdopodobieństwu. |
Te funkcje działają na homogenicznych listach liczb, dat i godzin i czasów trwania.
Nazwa/nazwisko | opis |
---|---|
List.Average | Zwraca średnią wartość z listy w typie 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. Tabela List.StandardDeviation wykonuje szacowanie na podstawie próbki. Wynikiem jest liczba liczb oraz czas trwania wartości DateTimes i Durations. |
Te funkcje działają na jednorodnych listach liczb lub czasów trwania.
Nazwa/nazwisko | opis |
---|---|
List.Sum | Zwraca sumę z listy. |
Te funkcje działają tylko nad liczbami.
Nazwa/nazwisko | opis |
---|---|
List.Covariance | Zwraca kowariancję z dwóch list jako liczbę. |
List.Product | Zwraca produkt z listy liczb. |
Te funkcje generują listę wartości.
Nazwa/nazwisko | 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 z liczby rozmiarów, począwszy od początku 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 z liczby rozmiarów, począwszy od początku i dodaje przyrost do każdej wartości. |
List.Generate | Generuje listę wartości. |
List.Numbers | Zwraca listę liczb z liczby rozmiarów rozpoczynających się od początku i dodaje przyrost. Wartość domyślna przyrostu to 1. |
List.Random | Zwraca listę liczb losowych z opcjonalnym parametrem inicjowania. |
List.Times | Zwraca listę wartości czasu liczby rozmiarów, począwszy od początku. |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Ascending = 0;
- Order.Descending = 1;
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 pozycji Funkcje porównujące.
- Wartość listy, która ma:
- 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 pozycji List.Distinct.
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 tematu Sortuj kolejność.
- 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, zobacz List.Sort.
Operacje zastępcze są określane przez wartość listy. 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.