Funkce seznamu

Tyto funkce vytvářejí hodnoty seznamu a manipulují s nimi.

Informace

Jméno	Popis
List.Count	Vrátí počet položek v seznamu.
List.IsEmpty	Vrátí true, pokud je seznam prázdný.
List.NonNullCount	Vrátí počet položek, které nejsou null v seznamu.

Selekce

Jméno	Popis
List.Alternate	Vrátí seznam složený ze všech lichých očíslovaných posunových prvků v seznamu.
List.Buffer	Vytvoří vyrovnávací paměť seznamu.
List.Distinct	Vrátí seznam hodnot s odebranými duplicitními položkami.
List.FindText	Vrátí seznam hodnot (včetně polí záznamů), které obsahují zadaný text.
List.First	Vrátí první hodnotu seznamu nebo zadanou výchozí hodnotu, pokud je prázdná.
List.FirstN	Vrátí první sadu položek v seznamu zadáním počtu položek, které se mají vrátit, nebo opravňující podmínky.
List.InsertRange	Vloží hodnoty do seznamu na daný index.
List.IsDistinct	Určuje, jestli jsou v seznamu duplicitní položky.
List.Last	Vrátí poslední hodnotu seznamu nebo zadanou výchozí hodnotu, pokud je prázdná.
List.LastN	Vrátí poslední hodnotu v seznamu. Volitelně můžete zadat, kolik hodnot se má vrátit, nebo kvalifikující podmínku.
List.MatchesAll	Vrátí true, pokud je funkce podmínky splněna všemi hodnotami v seznamu.
List.MatchesAny	Vrátí true, pokud je funkce podmínky splněna libovolnou hodnotou.
List.Positions	Vrátí seznam posunů pro zadaný vstup.
List.Range	Vrátí podmnožinu seznamu, která začíná od zadaného offsetu.
List.Select	Vrátí seznam hodnot, které odpovídají podmínce.
List.Single	Vrátí jedinou položku, pokud má seznam délku jedna, jinak vyvolá výjimku.
List.SingleOrDefault	Vrátí položku seznamu, pokud seznam obsahuje jednu položku, a výchozí hodnotu, pokud je seznam prázdný.
List.Skip	Vrátí seznam, který přeskočí zadaný počet prvků na začátku seznamu.

Transformační funkce

Jméno	Popis
List.Accumulate	AAccumuluje souhrnnou hodnotu z položek v seznamu.
List.Combine	Vrátí jeden seznam kombinací více seznamů.
List.ConformToPageReader	Tato funkce je určená pouze pro interní použití.
List.RemoveFirstN	Vrátí seznam, který přeskočí zadaný počet prvků na začátku seznamu.
List.RemoveItems	Odebere položky z prvního seznamu, které jsou přítomné v druhém seznamu.
List.RemoveLastN	Vrátí seznam, který odebere zadaný počet prvků na konci seznamu.
List.RemoveMatchingItems	Odebere všechny výskyty vstupních hodnot.
List.RemoveNulls	Odebere všechny null hodnoty ze zadaného seznamu.
List.RemoveRange	Odebere počet hodnot počínaje zadanou pozicí.
List.Repeat	Vrátí seznam, který je opakován countkrát z původního seznamu.
List.ReplaceMatchingItems	Nahradí výskyty existujících hodnot v seznamu novými hodnotami, které odpovídají podmínce.
List.ReplaceRange	Nahradí count počet hodnot začínajících na position náhradními hodnotami.
List.ReplaceValue	Vyhledá v seznamu zadanou hodnotu a nahradí ji.
List.Reverse	Vrátí pořadí hodnot v seznamu.
List.Split	Rozdělí zadaný seznam na seznam seznamů pomocí zadané velikosti stránky.
List.Transform	Vrátí nový seznam hodnot vypočítaných z tohoto seznamu.
List.TransformMany	Vrátí seznam, jehož prvky jsou transformovány ze vstupního seznamu pomocí zadaných funkcí.
List.Zip	Vrátí seznam seznamů kombinováním položek na stejné pozici ve více seznamech.

Funkce členství

Vzhledem k tomu, že všechny hodnoty lze testovat na rovnost, můžou tyto funkce pracovat s heterogenními seznamy.

Jméno	Popis
List.AllTrue	Vrátí true, pokud jsou všechny výrazy pravdivé.
List.AnyTrue	Vrátí hodnotu true, pokud je nějaký výraz pravdivý.
List.Contains	Určuje, zda seznam obsahuje hodnotu.
List.ContainsAll	Určuje, kde seznam obsahuje všechny hodnoty v jiném seznamu.
List.ContainsAny	Určuje, kde seznam obsahuje některou z hodnot v jiném seznamu.
List.PositionOf	Vrátí posuny hodnoty v seznamu.
List.PositionOfAny	Vrátí první posun hodnoty v seznamu.

Nastavení operací

Jméno	Popis
List.Difference	Vrátí rozdíl dvou zadaných seznamů.
List.Intersect	Vrátí průnik hodnot seznamu přítomných ve vstupu.
List.Union	Vrátí sjednocení hodnot seznamu nalezených ve vstupu.

Objednávání

Funkce pro řazení provádějí porovnání. Všechny porovnávané hodnoty musí být vzájemně srovnatelné. To znamená, že všechny musí pocházet ze stejného datového typu (nebo musí obsahovat hodnotu null, která vždy porovnává nejmenší). V opačném případě se vyvolá Expression.Error.

Srovnatelné datové typy zahrnují:

• Číslo
• Trvání
• Datum a čas
• Text
• Logický
• Nula

Jméno	Popis
List.Max	Vrátí maximální hodnotu nebo výchozí hodnotu prázdného seznamu.
List.MaxN	Vrátí maximální hodnoty v seznamu. Je třeba zadat počet hodnot, které se mají vrátit, nebo podmínku filtrování.
List.Median	Vrátí medián hodnoty v seznamu.
List.Min	Vrátí minimální hodnotu nebo výchozí hodnotu prázdného seznamu.
List.MinN	Vrátí minimální hodnoty v seznamu. Je možné zadat počet hodnot, které se mají vrátit, nebo podmínku filtrování.
List.Sort	Seřadí seznam dat podle zadaných kritérií.
List.Percentile	Vrátí jeden nebo více percentilů vzorku odpovídajících zadaným pravděpodobnostem.

Průměry

Tyto funkce pracují s homogenními seznamy čísel, datumových časů a délek trvání.

Jméno	Popis
List.Average	Vrátí průměr hodnot. Funguje s hodnotami number, date, datetime, datetimezone a duration.
List.Mode	Vrátí nejčastější hodnotu v seznamu.
List.Modes	Vrátí seznam nejčastějších hodnot v seznamu.
List.StandardDeviation	Vrátí odhad směrodatné odchylky na základě vzorku. Tato funkce provádí odhad založený na vzorku. Výsledkem je číselná hodnota pro numerické hodnoty a časový úsek pro hodnoty typu datum a doba trvání.

Přidání

Tyto funkce fungují v homogenních seznamech čísel nebo dob trvání.

Jméno	Popis
List.Sum	Vrátí součet položek v seznamu.

Číselné hodnoty

Tyto funkce pracují jenom s čísly.

Jméno	Popis
List.Covariance	Vrátí kovarianci mezi dvěma seznamy čísel.
List.Product	Vrátí součin čísel v seznamu.

Generátory

Tyto funkce generují seznam hodnot.

Jméno	Popis
List.Dates	Vygeneruje seznam hodnot date s počáteční hodnotou, počtem a přírůstkovou dobou trvání.
List.DateTimes	Vygeneruje seznam hodnot datetime s počáteční hodnotou, počtem a přírůstkovou dobou trvání.
List.DateTimeZones	Vygeneruje seznam hodnot datetimezone s počáteční hodnotou, počtem a přírůstkovou dobou trvání.
List.Durations	Vygeneruje seznam hodnot duration s počáteční hodnotou, počtem a přírůstkovou dobou trvání.
List.Generate	Vygeneruje seznam hodnot.
List.Numbers	Vrátí seznam čísel zadaných počáteční hodnotou, počtem a nepovinnou hodnotou přírůstku.
List.Random	Vrátí seznam náhodných čísel.
List.Times	Vygeneruje seznam hodnot time s počáteční hodnotou, počtem a přírůstkovou dobou trvání.

Hodnoty parametrů

Specifikace výskytu

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Událost.Všechny = 2;

Řazení

• Order.Ascending = 0;
• Order.Descending = 1;

Kritéria rovnice

Kritéria rovnice pro hodnoty seznamu lze zadat takto:

• Hodnota funkce, která je buď:
  • Selektor klíčem, který určuje hodnotu v seznamu pro použití kritérií rovnosti.
  • Porovnávací funkce, která se používá k určení druhu porovnání, který se má použít. Lze zadat předdefinované funkce porovnávače – přejděte na funkce porovnávače.
• Seznamová hodnota, která má:
  • Přesně dvě položky.
  • Prvním prvkem je selektor klíčů, jak je uvedeno výše.
  • Druhý prvek je porovnávač, jak je uvedeno výše.

Další informace a příklady najdete v tématu List.Distinct.

Srovnávací kritéria

Kritérium porovnání lze zadat jako jednu z následujících hodnot:

• Číselná hodnota pro zadání pořadí řazení. Další informace najdete v pořadí řazení.
• K výpočtu klíče, který se má použít k řazení, lze použít funkci jednoho argumentu.
• Pokud chcete vybrat klíč i pořadí ovládacích prvků, může být kritérium porovnání seznam obsahující klíč a pořadí.
• K úplnému řízení porovnání lze použít funkci dvou argumentů, která vrátí hodnotu -1, 0 nebo 1 vzhledem k relaci mezi vstupy zleva a doprava. Value.Compare je metoda, která se dá použít k delegování této logiky.

Další informace a příklady najdete v tématu List.Sort.

Operace nahrazení

Operace nahrazení jsou určeny seznamem hodnot. Každá položka tohoto seznamu musí být:

• Hodnota seznamu s přesně dvěma položkami
• První položka je stará hodnota v seznamu, která se má nahradit.
• Druhá položka je nová hodnota, která by měla nahradit všechny výskyty staré hodnoty v seznamu.