Zdieľať cez

Funkcie zoznamu

  • Článok

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

Informácia

Meno Popis
List.Count Vráti počet položiek v zozname.
List.IsEmpty Vráti true ak je zoznam prázdny.
List.NonNullCount Vráti počet položiek bez hodnoty null v zozname.

Výber

Meno Popis
List.Alternate Vráti zoznam skladaci sa zo všetkých nepárnych prvkov posunu v zozname.
List.Buffer Pridajte zoznam do medzipamäte.
List.Distinct Vráti zoznam hodnôt s odstránenými duplikátmi.
List.FindText Vráti zoznam hodnôt (vrátane polí záznamu), ktoré obsahujú zadaný text.
List.First Vráti prvú hodnotu zoznamu alebo daná predvolená hodnota, ak je zoznam prázdny.
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.
List.InsertRange Vloží hodnoty do zoznamu v danom indexe.
List.IsDistinct Udáva, či sa v zozname nachádzajú duplikáty.
List.Last Vráti poslednú hodnotu zoznamu alebo zadanú predvolenú hodnotu, ak je zoznam prázdny.
List.LastN Vráti poslednú hodnotu v zozname. Môžete voliteľne zadať počet hodnôt, ktoré sa majú vrátiť, alebo oprávňujúce podmienku.
List.MatchesAll Vráti true ak je funkcia podmienky splnená všetkými hodnotami v zozname.
List.MatchesAny Vráti true ak je funkcia podmienky splnená ľubovoľnou hodnotou.
List.Positions Vráti zoznam posunov pre vstup.
List.Range Vráti podmnožinu zoznamu začínajúc pri posune.
List.Select Vráti zoznam hodnôt, ktoré spĺňajú podmienku.
List.Single Vráti jednu položku zoznamu pre jeden zoznam s dĺžkou jeden, v opačnom prípade dôjde k výnimke.
List.SingleOrDefault Vráti jednu položku zoznamu pre zoznam s dĺžkou 1 a predvolenú hodnotu pre prázdny zoznam.
List.Skip Vráti zoznam, ktorý vynechá zadaný počet prvkov na začiatku zoznamu.

Funkcie transformácie

Meno Popis
List.Accumulate Akumuluje súhrnnú hodnotu z položiek v zozname.
List.Combine Vráti jeden zoznam skombinovaním viacerých zoznamov.
List.ConformToPageReader Táto funkcia je určená len na interné použitie.
List.RemoveFirstN Vráti zoznam, ktorý vynechá zadaný počet prvkov na začiatku zoznamu.
List.RemoveItems Odstráni položky z prvého zoznamu, ktoré sa nachádzajú v druhom zozname.
List.RemoveLastN Vráti zoznam, ktorý odstráni zadaný počet prvkov z konca zoznamu.
List.RemoveMatchingItems Odstráni všetky výskyty vstupných hodnôt.
List.RemoveNulls Odstráni všetky null hodnoty zo zadaného zoznamu.
List.RemoveRange Odstráni počet hodnôt count počnúc na zadanej pozícii.
List.Repeat Vráti zoznam, ktorý je count opakovania pôvodného zoznamu.
List.ReplaceMatchingItems Nahradí výskyty existujúcich hodnôt v zozname novými hodnotami, ktoré spĺňajú podmienku.
List.ReplaceRange Nahradí count počtom hodnôt začínajúcich od position náhradnými hodnotami.
List.ReplaceValue V zozname vyhľadá zadanú hodnotu a nahradí ju.
List.Reverse Obráti poradie hodnôt v zozname.
List.Split Rozdelí zadaný zoznam na zoznam zoznamov použitím zadanej veľkosti strany.
List.Transform Vráti nový zoznam hodnôt vypočítaných z tohto zoznamu.
List.TransformMany Vráti zoznam, ktorého prvky sa transformujú zo vstupného zoznamu pomocou zadaných funkcií.
List.Zip Vráti zoznam zoznamov skombinovaním položiek na tej istej pozícii vo viacerých zoznamoch.

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 true, ak majú všetky výrazy hodnotu true.
List.AnyTrue Vráti hodnotu true, ak má ľubovoľný výraz hodnotu true.
List.Contains Udáva, či zoznam obsahuje hodnotu.
List.ContainsAll Udáva, kde zoznam obsahuje všetky hodnoty v inom zozname.
List.ContainsAny Udáva, kde zoznam obsahuje niektorú z hodnôt v inom zozname.
List.PositionOf Vráti posun (posuny) hodnoty v zozname.
List.PositionOfAny Vráti prvý posun hodnoty v zozname.

Operácie s množinami

Meno Popis
List.Difference Vráti rozdiel dvoch daných zoznamov.
List.Intersect Vráti prienik hodnôt zoznamu nájdených vo vstupe.
List.Union Vráti zjednotenie hodnôt zoznamu nájdených vo vstupe.

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 hodnotu alebo predvolenú hodnotu prázdneho zoznamu.
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 hodnotu mediánu v zozname.
List.Min Vráti minimálnu hodnotu alebo predvolenú hodnotu prázdneho zoznamu.
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 Zoradí zoznam údajov podľa stanovených kritérií.
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 priemer hodnôt. Funguje s číslom, dátumom, dátumom a časom, hodnotami datetimezone a trvania.
List.Mode Vráti najčastejšiu hodnotu v zozname.
List.Modes Vráti zoznam najčastejších hodnôt v zozname.
List.StandardDeviation Vráti odhad smerodajnej odchýlky na základe vzorky. Táto funkcia 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 položiek v zozname.

Číselné hodnoty

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

Meno Popis
List.Covariance Vráti kovarianciu medzi dvomi zoznamami čísel.
List.Product Vráti súčin čísel v zozname.

Generátory

Tieto funkcie generujú zoznam hodnôt.

Meno Popis
List.Dates Vygeneruje zoznam date hodnôt s danou počiatočnou hodnotou, počtom a prírastkovou hodnotou trvania.
List.DateTimes Vygeneruje zoznam datetime hodnôt s danou počiatočnou hodnotou, počtom a prírastkovou hodnotou trvania.
List.DateTimeZones Vygeneruje zoznam datetimezone hodnôt s danou počiatočnou hodnotou, počtom a prírastkovou hodnotou trvania.
List.Durations Vygeneruje zoznam duration hodnôt s danou počiatočnou hodnotou, počtom a prírastkovou hodnotou trvania.
List.Generate Vygeneruje zoznam hodnôt.
List.Numbers Vráti zoznam čísel s danou počiatočnou hodnotou, počtom a voliteľnou hodnotou prírastku.
List.Random Vráti zoznam náhodných čísel.
List.Times Vygeneruje zoznam time hodnôt s danou počiatočnou hodnotou, počtom a prírastkovou hodnotou trvania.

Hodnoty parametrov

Špecifikácia výskytu

Zoradenia

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.