Udostępnij za pośrednictwem

Lista funkcji

  • Artykuł

Te funkcje tworzą wartości list i manipulują nimi.

Informacja

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.

Wybór

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 countOrConditionprogram .
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 countOrConditionprogram .
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.

Funkcje przekształcania

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 list2i 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 equationCriteriaelementu . 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.

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/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ę.

Ustawianie operacji

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.

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 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.

Średnie

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.

Dodatek

Te funkcje działają na jednorodnych listach liczb lub czasów trwania.

Nazwa/nazwisko opis
List.Sum Zwraca sumę z listy.

Wartości numeryczne

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.

Generatory

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.

Wartości parametrów

Specyfikacja wystąpienia

Kolejność sortowania

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 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.

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 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

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.