Funkce seznamu
Tyto funkce vytvářejí hodnoty seznamu a manipulují s nimi.
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ý. |
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. |
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. |
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. |
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í 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. |
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. |
Tyto funkce fungují v homogenních seznamech čísel nebo dob trvání.
Jméno | popis |
---|---|
List.Sum | Vrátí součet ze seznamu. |
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. |
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. |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Ascending = 0;
- Order.Descending = 1;
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.
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í 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.