Udostępnij za pomocą

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 listę ostatniego elementu lub elementów na określonej 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, które mają zostać zwrócone lub warunek filtru.
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 filtru.
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

Kolejność sortowania

Kryteria równania

W wielu funkcjach listy parametr wskazuje, equationCriteria jak równość jest określana między elementami listy. 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. Wbudowane funkcje porównania można określić — przejdź do pozycji Funkcje porównujące.
  • 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.

W większości funkcji listy funkcja porównująca używana w parametrze equationCriteria musi być jedną z wbudowanych funkcji porównywania. W tych funkcjach listy użycie niestandardowego modułu porównującego powoduje wystąpienie błędu. Jednak następujące funkcje listy umożliwiają korzystanie z niestandardowego modułu porównującego:

Aby uzyskać więcej informacji i przykładów, przejdź do List.Distinct i List.PositionOf.

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.
  • Last updated on