Funkcie zoznamu

Tieto funkcie umožňujú vytvoriť a upraviť hodnoty zoznamu.

Informácia

Meno	Popis
List.Count	Vráti počet položiek v zozname.
List.NonNullCount	Vráti počet položiek v zozname s výnimkou hodnôt null
List.IsEmpty	Vráti informáciu, či je zoznam prázdny.

Výber

Meno	Popis
List.Alternate	Vráti zoznam s položkami striedanými z pôvodného zoznamu na základe počtu, voliteľného argumentu repeatInterval a voliteľného posunu.
List.Buffer	Načíta zoznam do medzipamäte. Výsledkom tohto volania je stabilný zoznam, čo znamená, že bude mať determinický počet a poradie položiek.
List.Distinct	Filtruje zoznam odstránením duplikátov. Ak chcete ovládať porovnávanie rovnosti, môžete zadať voliteľnú hodnotu kritéria rovnice. Vyberie sa prvá hodnota z každej skupiny rovnosti.
List.FindText	Prehľadá zoznam hodnôt vrátane polí záznamov pre textovú hodnotu.
List.First	Vráti prvú hodnotu zoznamu alebo daná predvolená hodnota, ak je zoznam prázdny. Vráti prvú položku v zozname alebo voliteľnú predvolenú hodnotu, ak je zoznam prázdny. Ak je zoznam prázdny a predvolená hodnota nie je zadaná, funkcia vráti.
List.FirstN	Vráti prvú množinu položiek v zozname stanovením počtu položiek, ktoré sa majú vrátiť, alebo oprávňujúcu podmienku poskytnutú countOrCondition.
List.InsertRange	Vloží položky z hodnôt v danom indexe do vstupného zoznamu.
List.IsDistinct	Vráti informáciu, či je zoznam odlišný.
List.Last	Vráti poslednú množinu položiek v zozname stanovením počtu položiek, ktoré sa majú vrátiť, alebo oprávňujúcu podmienku poskytnutú countOrCondition.
List.LastN	Vráti poslednú množinu položiek v zozname stanovením počtu položiek, ktoré sa majú vrátiť, alebo oprávňujúcu podmienku.
List.MatchesAll	Vráti hodnotu true, ak všetky položky v zozname spĺňajú podmienku.
List.MatchesAny	Vráti hodnotu true, ak akákoľvek položka v zozname spĺňa podmienku.
List.Positions	Vráti zoznam pozícií pre vstupný zoznam.
List.Range	Vráti položky počtu začínajúce pri posune.
List.Select	Vyberie položky, ktoré zodpovedajú podmienke.
List.Single	Vráti jednu položku zoznamu alebo vráti Expression.Error, ak zoznam obsahuje viac ako jednu položku.
List.SingleOrDefault	Vráti jednu položku zo zoznamu.
List.Skip	Vynechá prvú položku zoznamu. Ak je daný prázdny zoznam, vráti sa prázdny zoznam. Táto funkcia vezme voliteľný parameter countOrCondition na podporu vynechania viacerých hodnôt.

Funkcie transformácie

Meno	Popis
List.Accumulate	Akumuluje výsledok zo zoznamu. Začínajúc od počiatočnej hodnoty táto funkcia použije funkciu akumulátora a vráti konečný výsledok.
List.Combine	Zlúči zoznam zoznamov do jedného zoznamu.
List.ConformToPageReader	Táto funkcia je určená len na interné použitie.
List.RemoveRange	Vráti zoznam, ktorý odstraňuje položky počtu začínajúce pri posune. Predvolený počet je 1.
List.RemoveFirstN	Vráti zoznam so zadaným počtom prvkov odstránených zo zoznamu počnúc prvým prvkom. Počet odstránených prvkov závisí od voliteľného parametra countOrCondition.
List.RemoveItems	Odstráni položky z list1 , ktoré sa nachádzajú v list2, a vráti nový zoznam.
List.RemoveLastN	Vráti zoznam so zadaným počtom prvkov odstránených zo zoznamu počnúc posledným prvkom. Počet odstránených prvkov závisí od voliteľného parametra countOrCondition.
List.Repeat	Vráti zoznam, ktorý opakuje obsah vstupného zoznamu zadaný počet krát.
List.ReplaceRange	Vráti zoznam, ktorý nahradí hodnoty počtu v zozname replaceWith zoznamom začínajúcim s indexom.
List.RemoveMatchingItems	Odstráni všetky výskyty daných hodnôt v zozname.
List.RemoveNulls	Odstráni hodnoty null zo zoznamu.
List.ReplaceMatchingItems	Nahradí výskyty existujúcich hodnôt v zozname novými hodnotami pomocou poskytnutého equationCriteria. Staré a nové hodnoty sú poskytované parametrami replacements. Ak chcete ovládať porovnávania rovnosti, môžete zadať voliteľnú hodnotu kritéria rovnice. Podrobnosti o operáciách nahrádzania a kritériách rovníc nájdete v hodnotách parametrov.
List.ReplaceValue	V zozname hodnôt vyhľadá hodnotu a nahradí každý výskyt náhradnou hodnotou.
List.Reverse	Vráti zoznam, ktorý vráti späť položky v zozname.
List.Split	Rozdelí zadaný zoznam na zoznam zoznamov použitím zadanej veľkosti strany.
List.Transform	Vykoná funkciu na každej položke v zozname a vráti nový zoznam.
List.TransformMany	Vráti zoznam, ktorého prvky sa premietajú zo vstupného zoznamu.

Funkcie členstva

Keďže všetky hodnoty je možné testovať na rovnosť, tieto funkcie môžu fungovať v heterogénnych zoznamoch.

Meno	Popis
List.AllTrue	Vráti hodnotu true, ak majú všetky výrazy v zozname hodnotu true
List.AnyTrue	Vráti hodnotu true, ak má akýkoľvek výraz v zozname hodnotu true
List.Contains	Vráti hodnotu TRUE, ak sa v zozname nájde hodnota.
List.ContainsAll	Vráti hodnotu TRUE, ak sa v zozname nájdu všetky položky v hodnotách.
List.ContainsAny	Vráti hodnotu true, ak sa v zozname nájde akákoľvek položka v hodnotách.
List.PositionOf	Nájde prvý výskyt hodnoty v zozname a vráti jeho pozíciu.
List.PositionOfAny	Nájde prvý výskyt ľubovoľnej hodnoty v hodnotách a vráti jej pozíciu.

Operácie s množinami

Meno	Popis
List.Difference	Vráti položky v zozname list 1, ktoré sa nevybrajú v zozname list 2. Duplicitné hodnoty sú podporované.
List.Intersect	Vráti zoznam zo zoznamu zoznamov a pretína bežné položky v jednotlivých zoznamoch. Duplicitné hodnoty sú podporované.
List.Union	Vráti zoznam zo zoznamu zoznamov a spojí položky v jednotlivých zoznamoch. Vrátený zoznam obsahuje všetky položky vo všetkých vstupných zoznamoch. Duplicitné hodnoty sa pridajú ako súčasť zjednotenia.
List.Zip	Vráti zoznam zoznamov, pričom skombinuje položky na tej istej pozícii.

Objednávanie

Funkcie zoradenia vykonávajú porovnania. Všetky porovnávané hodnoty musia byť vzájomne porovnateľné. To znamená, že všetky musia mať rovnaký typ údajov (alebo obsahujú hodnotu null, ktorá sa vždy porovná ako najmenšia hodnota). V opačnom prípade sa vyfiltruje Expression.Error.

Porovnateľné typy údajov zahŕňajú:

• Číslo
• Trvanie
• Dátum a čas
• Text
• Logický
• Nula

Meno	Popis
List.Max	Vráti maximálnu položku v zozname alebo voliteľnú predvolenú hodnotu, ak je zoznam prázdny.
List.MaxN	Vráti maximálne hodnoty v zozname. Musí byť zadaný počet hodnôt, ktoré sa majú vrátiť, alebo podmienka filtrovania.
List.Median	Vráti položku mediánu zo zoznamu.
List.Min	Vráti minimálnu položku v zozname alebo voliteľnú predvolenú hodnotu, ak je zoznam prázdny.
List.MinN	Vráti minimálne hodnoty v zozname. Môže sa zadať počet hodnôt, ktoré sa majú vrátiť, alebo podmienka filtrovania.
List.Sort	Vráti zoradený zoznam s použitím kritéria porovnania.
List.Percentile	Vráti jeden alebo viac percentilov vzorky zodpovedajúcich daným pravdepodobnostiam.

Priemery

Tieto funkcie fungujú v homogénnych zoznamoch s číslami, dátumom a časom a trvaním.

Meno	Popis
List.Average	Vráti priemernú hodnotu zo zoznamu v údajovom type hodnôt v zozname.
List.Mode	Vráti položku, ktorá sa najčastejšie vyskytuje v zozname.
List.Modes	Vráti všetky položky, ktoré sa zobrazujú s rovnakou maximálnou frekvenciou.
List.StandardDeviation	Vráti smerodajnú odchýlku zo zoznamu hodnôt. List.StandardDeviation vykoná odhad na základe vzorky. Výsledkom je číslo pre čísla a trvanie pre dátum a čas a trvanie.

Sčítanie

Tieto funkcie fungujú v homogénnych zoznamoch s číslami alebo trvaním.

Meno	Popis
List.Sum	Vráti súčet zo zoznamu.

Číselné hodnoty

Tieto funkcie fungujú iba s číselnými hodnotami.

Meno	Popis
List.Covariance	Vráti kovarianciu z dvoch zoznamov ako číslo.
List.Product	Vráti produkt zo zoznamu čísel.

Generátory

Tieto funkcie generujú zoznam hodnôt.

Meno	Popis
List.Dates	Vráti zoznam hodnôt dátumu z počtu veľkostí, pričom začína od začiatku a pridá prírastok ku každej hodnote.
List.DateTimes	Vráti zoznam hodnôt dátumu a času z počtu veľkostí, pričom začína od začiatku a pridá prírastok ku každej hodnote.
List.DateTimeZones	Vráti zoznam hodnôt datetimezone z počtu veľkostí, pričom začína od začiatku a pridá prírastok ku každej hodnote.
List.Durations	Vráti zoznam hodnôt trvaní z počtu veľkostí, pričom začína od začiatku a pridá prírastok ku každej hodnote.
List.Generate	Vygeneruje zoznam hodnôt.
List.Numbers	Vráti zoznam čísel z počtu veľkostí, pričom začína z počiatočnej hodnoty a pridáva prírastok. Prírastok je predvolene nastavený na hodnotu 1.
List.Random	Vráti zoznam náhodných čísel s voliteľným počiatočným parametrom.
List.Times	Vráti zoznam hodnôt času počtu veľkostí, počnúc od začiatku.

Hodnoty parametrov

Špecifikácia výskytu

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Occurrence.All = 2;

Zoradenia

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

Kritériá rovnice

Kritériá rovnice pre hodnoty zoznamu možno zadať buď takto:

• Hodnota funkcie, ktorá je buď:
  • Selektor kľúča, ktorý určuje hodnotu v zozname na použitie kritérií rovnosti.
  • Funkcia porovnávača, ktorá sa používa na určenie druhu porovnania, ktorý sa má použiť. Zabudované funkcie porovnávača možno zadať – prejdite na funkcií porovnávača.
• Hodnota zoznamu, ktorá obsahuje:
  • Presne dve položky.
  • Prvým prvkom je selektor kľúča, ako je uvedené vyššie.
  • Druhý prvok je porovnávač, ako je uvedené vyššie.

Ďalšie informácie a príklady nájdete v List.Distinct.

Kritériá porovnania

Kritérium porovnania možno zadať ako jednu z nasledujúcich hodnôt:

• Číselná hodnota na zadanie poradia zoradenia. Ďalšie informácie nájdete v zoradenie.
• Ak chcete vypočítať kľúč, ktorý sa má použiť na zoradenie, možno použiť funkciu jedného argumentu.
• Ak chcete vybrať kľúč aj ovládať poradie, kritériom porovnania môže byť zoznam obsahujúci kľúč a poradie.
• Ak chcete úplne ovládať porovnanie, môžete použiť funkciu dvoch argumentov, ktoré vrátia hodnotu -1, 0 alebo 1 vzhľadom na vzťah medzi ľavým a pravým vstupom. Value.Compare je metóda, ktorá sa dá použiť na delegovanie tejto logiky.

Ďalšie informácie a príklady nájdete v List.Sort.

Operácie nahradenia

Operácie nahradenia sú zadané hodnotou zoznamu. Každá položka tohto zoznamu musí byť:

• Hodnota zoznamu s presne dvomi položkami.
• Prvou položkou je stará hodnota v zozname, ktorá sa má nahradiť.
• Druhá položka je nová hodnota, ktorá by mala nahradiť všetky výskyty starej hodnoty v zozname.