Číst v angličtině

Sdílet prostřednictvím


Funkce seznamu

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

Informační

Jméno popis
List.Count Vrátí počet položek v seznamu.
List.NonNullCount Vrátí počet položek v seznamu s výjimkou hodnot null.
List.IsEmpty Vrátí, zda je seznam prázdný.

Výběr

Jméno popis
List.Alternate Vrátí seznam s položkami střídavými z původního seznamu na základě počtu, volitelného repeatIntervalu a volitelného posunu.
List.Buffer Zapíše seznam do vyrovnávací paměti. Výsledkem tohoto volání je stabilní seznam, což znamená, že bude mít determinimický počet a pořadí položek.
List.Distinct Filtruje seznam dolů odebráním duplicit. K řízení porovnání rovnosti je možné zadat volitelnou hodnotu kritérií rovnice. Vybere se první hodnota z každé skupiny rovnosti.
List.FindText Vyhledá textovou hodnotu v seznamu hodnot, včetně polí záznamu.
List.First Vrátí první hodnotu seznamu nebo zadanou výchozí hodnotu, pokud je prázdná. Vrátí první položku v seznamu nebo volitelnou výchozí hodnotu, pokud je seznam prázdný. Pokud je seznam prázdný a není zadána výchozí hodnota, vrátí funkce.
List.FirstN Vrátí první sadu položek v seznamu zadáním počtu položek, které mají být vráceny, nebo opravňující podmínky poskytnuté countOrCondition.
List.InsertRange Vloží položky z hodnot na daný index ve vstupním seznamu.
List.IsDistinct Vrátí, zda je seznam jedinečný.
List.Last Vrátí poslední sadu položek v seznamu zadáním počtu položek, které mají být vráceny, nebo opravňující podmínky poskytnuté countOrCondition.
List.LastN Vrátí poslední sadu položek v seznamu zadáním počtu položek, které se mají vrátit, nebo opravňující podmínky.
List.MatchesAll Vrátí hodnotu true, pokud všechny položky v seznamu splňují podmínku.
List.MatchesAny Vrátí hodnotu true, pokud některá položka v seznamu splňuje podmínku.
List.Positions Vrátí seznam pozic vstupního seznamu.
List.Range Vrátí počet položek začínajících posunem.
List.Select Vybere položky, které odpovídají podmínce.
List.Single Vrátí jednu položku seznamu nebo vyvolá Expression.Error výjimku, pokud seznam obsahuje více než jednu položku.
List.SingleOrDefault Vrátí jednu položku ze seznamu.
List.Skip Přeskočí první položku seznamu. Pokud je seznam prázdný, vrátí prázdný seznam. Tato funkce přebírá volitelný parametr countOrCondition , který podporuje přeskočení více hodnot.

Transformační funkce

Jméno popis
List.Kumulovat Nahromáždí výsledek ze seznamu. Počínaje počáteční hodnotou počáteční počáteční hodnota tato funkce použije funkci akumulátoru a vrátí konečný výsledek.
List.Combine Sloučí seznam seznamů do jednoho seznamu.
List.ConformToPageReader Tato funkce je určená pouze pro interní použití.
List.RemoveRange Vrátí seznam, který odebere položky počtu začínající posunem. Výchozí počet je 1.
List.RemoveFirstN Vrátí seznam se zadaným počtem prvků odebraných ze seznamu počínaje prvním prvkem. Počet odebraných prvků závisí na volitelném countOrCondition parametru.
List.RemoveItems Odebere položky, list1 které jsou přítomné v list2, a vrátí nový seznam.
List.RemoveLastN Vrátí seznam se zadaným počtem prvků odebraných ze seznamu počínaje posledním prvkem. Počet odebraných prvků závisí na volitelném countOrCondition parametru.
List.Repeat Vrátí seznam, který opakuje obsah počtu vstupních seznamů.
List.ReplaceRange Vrátí seznam, který nahradí hodnoty počtu v seznamu seznamem replaceWith začínajícím indexem.
List.RemoveMatchingItems Odebere všechny výskyty daných hodnot v seznamu.
List.RemoveNulls Odebere hodnoty null ze seznamu.
List.ReplaceMatchingItems Nahradí výskyty existujících hodnot v seznamu novými hodnotami pomocí zadaného equationCriteria. Staré a nové hodnoty jsou poskytovány parametry replacements . Pro řízení porovnávání rovnosti je možné zadat volitelnou hodnotu kritérií rovnic. Podrobnosti o náhradních operacích a kritériích rovnic najdete v části Hodnoty parametrů.
List.ReplaceValue Vyhledá seznam hodnot pro danou hodnotu a nahradí každý výskyt náhradní hodnotou.
List.Reverse Vrátí seznam, který obrátí položky v seznamu.
List.Split Rozdělí zadaný seznam na seznam seznamů pomocí zadané velikosti stránky.
List.Transform Provede funkci pro každou položku v seznamu a vrátí nový seznam.
List.TransformMany Vrátí seznam, jehož prvky jsou promítané ze vstupního seznamu.

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í hodnotu true, pokud jsou splněny všechny výrazy v seznamu.
List.AnyTrue Vrátí hodnotu true, pokud některý výraz v seznamu má hodnotu true.
List.Contains Vrátí hodnotu true, pokud se v seznamu najde hodnota.
List.ContainsAll Vrátí hodnotu true, pokud jsou všechny položky v hodnotách nalezeny v seznamu.
List.ContainsAny Vrátí hodnotu true, pokud se v seznamu najde jakákoli položka v hodnotách.
List.PositionOf Vyhledá první výskyt hodnoty v seznamu a vrátí jeho pozici.
List.PositionOfAny Vyhledá první výskyt libovolné hodnoty v hodnotách a vrátí jeho pozici.

Nastavení operací

Jméno popis
List.Difference Vrátí položky v seznamu 1, které se nezobrazují v seznamu 2. Podporují se duplicitní hodnoty.
List.Intersect Vrátí seznam ze seznamu seznamů a protíná společné položky v jednotlivých seznamech. Podporují se duplicitní hodnoty.
List.Union Vrátí seznam ze seznamu seznamů a sjednocuje položky v jednotlivých seznamech. Vrácený seznam obsahuje všechny položky ve vstupních seznamech. Duplicitní hodnoty se shodují jako součást Unie.
List.Zip Vrátí seznam seznamů, které kombinují položky na stejné pozici.

Řazení

Řazení funkcí provádí 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ší). Expression.Error V opačném případě je vyvolán.

Srovnatelné datové typy zahrnují:

  • Počet
  • Doba trvání
  • DateTime
  • Text
  • Logický
  • Null
Jméno popis
List.Max Vrátí maximální položku v seznamu nebo volitelnou výchozí hodnotu, pokud je seznam prázdný.
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 položky ze seznamu.
List.Min Vrátí minimální položku v seznamu nebo volitelnou výchozí hodnotu, pokud je seznam prázdný.
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 Vrátí seřazený seznam pomocí kritéria porovnání.
List.Percentil 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, DateTimes a Durations.

Jméno popis
List.Average Vrátí průměrnou hodnotu ze seznamu v datovém typu hodnot v seznamu.
List.Mode Vrátí položku, která se zobrazuje nejčastěji v seznamu.
List.Modes Vrátí všechny položky, které se zobrazí se stejnou maximální frekvencí.
List.StandardDeviation Vrátí směrodatnou odchylku ze seznamu hodnot. List.StandardDeviation provádí odhad založený na vzorku. Výsledkem je číslo pro čísla a doba trvání pro hodnoty DateTimes a Durations.

Součet

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

Jméno popis
List.Sum Vrátí součet ze seznamu.

Numerické výpočty

Tyto funkce pracují jenom s čísly.

Jméno popis
List.Covariance Vrátí kovarianci ze dvou seznamů jako číslo.
List.Product Vrátí součin ze seznamu čísel.

Generátory

Tyto funkce generují seznam hodnot.

Jméno popis
List.Dates Vrátí seznam hodnot kalendářních dat z počtu velikostí počínaje začátkem a přičte k každé hodnotě přírůstek.
List.DateTimes Vrátí seznam hodnot datetime z počtu velikostí počínaje začátkem a přičte k každé hodnotě přírůstek.
List.DateTimeZones Vrátí seznam hodnot datetimezone z počtu velikostí počínaje počátečním datem a přičte k každé hodnotě přírůstek.
List.Durations Vrátí seznam hodnot doby trvání z počtu velikostí počínaje začátkem a přičte k každé hodnotě přírůstek.
List.Generate Vygeneruje seznam hodnot.
List.Numbers Vrátí seznam čísel z počtu velikostí začínajícího na začátku a sečte přírůstek. Výchozí hodnota přírůstku je 1.
List.Random Vrátí seznam náhodných čísel počtu s volitelným počátečním parametrem.
List.Times Vrátí seznam časových hodnot počtu velikostí počínaje začátkem.

Hodnoty parametrů

Specifikace výskytu

Pořadí řazení

Kritéria rovnice

Kritéria rovnice pro hodnoty seznamu lze zadat takto:

  • Hodnota funkce, která je buď:
    • Selektor klíče, který určuje hodnotu v seznamu, aby se použila kritéria rovnosti.
    • Porovnávací funkce, která se používá k určení druhu porovnání, který se má použít. Předdefinované funkce porovnávače je možné zadat – přejděte na funkce Compareru.
  • Hodnota seznamu, která obsahuje:
    • 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 hodnotou seznamu. 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.