Luettelofunktiot
Nämä funktiot luovat ja käsittelevät luetteloarvoja.
Nimi | Kuvaus |
---|---|
List.Count | Palauttaa luettelon kohteiden määrän. |
List.NonNullCount | Palauttaa luettelon kohteiden määrän ilman tyhjäarvoja. |
List.IsEmpty | Palauttaa tiedon siitä, onko luettelo tyhjä. |
Nimi | Kuvaus |
---|---|
List.Alternate | Palauttaa luettelon vuoroteltuna alkuperäisestä luettelosta määrän, valinnaisen toistuvan parametrin ja valinnaisen siirtymän perusteella. |
List.Buffer | Puskuroi luettelon muistiin. Tämän kutsun tulos on vakaa luettelo, mikä tarkoittaa, että sillä on deterministinen määrä ja kohdejärjestys. |
List.Distinct | Suodattaa luettelon alaspäin poistamalla kaksoiskappaleet. Valinnainen laskutoimituksen ehtoarvo voidaan määrittää ohjaamaan yhtäsuuruusvertailua. Kustakin yhtäläisyysryhmästä valitaan ensimmäinen arvo. |
List.FindText | Hakee tekstiarvon arvoluettelosta, tietuekentät mukaan lukien. |
List.First | Palauttaa luettelon ensimmäisen arvon tai määritetyn oletusarvon, jos se on tyhjä. Palauttaa ensimmäisen tietoyksikön luettelossa tai valinnaisen oletusarvon, jos luettelo on tyhjä. Jos luettelo on tyhjä eikä oletusarvoa ole määritetty, funktio palautuu. |
List.FirstN | Palauttaa luettelon ensimmäisen kohdejoukon määrittämällä, montako kohdetta palautetaan, tai ehdon, jonka countOrCondition antaa. |
List.InsertRange | Lisää kohteita syöteluettelossa olevan indeksin arvoista. |
List.IsDistinct | Palauttaa tiedon siitä, onko luettelo erillinen. |
List.Last | Palauttaa luettelon viimeisen kohdejoukon määrittämällä, montako kohdetta palautetaan, tai ehdon, jonka countOrCondition antaa. |
List.LastN | Palauttaa luettelon viimeisen kohdejoukon määrittämällä, montako kohdetta palautetaan, tai ehdon. |
List.MatchesAll | Palauttaa arvon true, jos luettelon kaikki kohteet täyttävät ehdon. |
List.MatchesAny | Palauttaa arvon true, jos luettelon jokin kohde täyttää ehdon. |
List.Positions | Palauttaa sijaintiluettelon syöteluettelolle. |
List.Range | Palauttaa kohteiden määrän siirtymästä alkaen. |
List.Select | Valitsee ehtoa vastaavat kohteet. |
List.Single | Palauttaa luettelon yksittäisen kohteen tai heittää Expression.Error , jos luettelossa on useampi kuin yksi kohde. |
List.SingleOrDefault | Palauttaa yksittäisen kohteen luettelosta. |
List.Skip | Ohittaa luettelon ensimmäisen kohteen. Jos luettelo on tyhjä, se palauttaa tyhjän luettelon. Tällä funktiolla on valinnainen parametrin countOrCondition , joka tukee useiden arvojen ohittamista. |
Nimi | Kuvaus |
---|---|
List.Accumulate | Kerää tuloksen luettelosta. Alkuarvosta aloittaen tämä funktio käyttää kumulatiivista funktiota ja palauttaa lopullisen tuloksen. |
List.Combine | Yhdistää luetteloiden luettelon yksittäiseksi luetteloksi. |
List.ConformToPageReader | Tämä funktio on tarkoitettu vain sisäiseen käyttöön. |
List.RemoveRange | Palauttaa luettelon, joka poistaa määräkohteet siirtymästä alkaen. Oletusmäärä on 1. |
List.RemoveFirstN | Palauttaa luettelon, joka sisältää määritetyn määrän luettelosta poistettuja elementtejä ensimmäisestä elementistä alkaen. Poistettujen elementtien määrä määräytyy valinnaisen countOrCondition parametrin mukaan. |
List.RemoveItems | Poistaa list2 olevat kohteet list1 ja palauttaa uuden luettelon. |
List.RemoveLastN | Palauttaa luettelon, joka sisältää määritetyn määrän luettelosta poistettuja elementtejä viimeisestä elementistä alkaen. Poistettujen elementtien määrä määräytyy valinnaisen countOrCondition parametrin mukaan. |
List.Repeat | Palauttaa luettelon, joka toistaa syöteluettelon laskentakertojen sisällön. |
List.ReplaceRange | Palauttaa luettelon, joka korvaa luettelon määrä-arvot replaceWith luettelolla indeksistä alkaen. |
List.RemoveMatchingItems | Poistaa luettelon annettujen arvojen kaikki esiintymät. |
List.RemoveNulls | Poistaa tyhjäarvot luettelosta. |
List.ReplaceMatchingItems | Korvaa luettelon olemassa olevien arvojen esiintymät uusilla arvoilla käyttäen annettua equationCriteria . vanhat ja uudet arvot saadaan replacements parametreista. Valinnainen laskutoimituksen ehtoarvo voidaan määrittää ohjaamaan yhtäsuuruusvertailua. Lisätietoja korvaamistoiminnoista ja kaavaehdoista on kohdassa Parametriarvot. |
List.ReplaceValue | Hakee arvoluettelosta arvoa ja korvaa kunkin esiintymän korvaavalla arvolla. |
List.Reverse | Palauttaa luettelon, joka kääntää luettelon kohteet käänteiseksi. |
List.Split | Jakaa määritetyn luettelon luetteloiden luetteloksi käyttäen määritettyä sivun kokoa. |
List.Transform | Suorittaa funktion luettelon kullekin kohteelle ja palauttaa uuden luettelon. |
List.TransformMany | Palauttaa luettelon, jonka elementit on projisoitu syöteluettelosta. |
Koska kaikkien arvojen yhdenvertaisuus voidaan testata, nämä funktiot voidaan suorittaa heterogeenisille luetteloille.
Nimi | Kuvaus |
---|---|
List.AllTrue | Palauttaa arvon true, jos kaikilla lausekkeilla on arvo true luettelossa. |
List.AnyTrue | Palauttaa arvon true, jos jollain lausekkeella on arvo true luettelossa. |
List.Contains | Palauttaa arvon true, jos arvo löytyy luettelosta. |
List.ContainsAll | Palauttaa arvon true, jos arvojen kaikki kohteet löytyvät luettelosta. |
List.ContainsAny | Palauttaa arvon true, jos arvojen jokin kohde löytyy luettelosta. |
List.PositionOf | Etsii luettelon arvon ensimmäisen esiintymän ja palauttaa sen sijainnin. |
List.PositionOfAny | Etsii arvojen minkä tahansa arvon ensimmäisen esiintymän ja palauttaa sen sijainnin. |
Nimi | Kuvaus |
---|---|
List.Difference | Palauttaa luettelossa 1 olevat kohteet, joita ei ole luettelossa 2. Arvojen kaksoiskappaleita tuetaan. |
List.Intersect | Palauttaa luettelon luetteloiden luettelosta ja leikkaa yleisiä kohteita yksittäisissä luetteloissa. Arvojen kaksoiskappaleita tuetaan. |
List.Union | Palauttaa luettelon luetteloiden luettelosta ja yhdistää yksittäisten luetteloiden kohteet. Palautettu luettelo sisältää kaikki syöteluetteloiden kohteet. Arvojen kaksoiskappaleille tehdään vastaavuus osana yhdistämistä. |
List.Zip | Palauttaa luetteloiden luettelon yhdistämällä samassa sijainnissa olevat kohteet. |
Järjestämisfunktiot suorittavat vertailuja. Kaikkien vertailtavan arvon on oltava keskenään vertailukelpoisia. Tämä tarkoittaa sitä, että kaikkien pitää olla peräisin samasta tietotyypistä (tai sisältää tyhjäarvon, joka on aina vertailun pienin). Muussa tapauksessa Expression.Error
heitetään.
Vertailukelpoisia tietotyyppejä ovat seuraavat:
- Numero
- Kesto
- Päivämäärä ja aika
- Tekstiviesti
- Looginen
- Nolla
Nimi | Kuvaus |
---|---|
List.Max | Palauttaa luettelon kohteiden enimmäisarvon tai valinnaisen oletusarvon, jos luettelo on tyhjä. |
List.MaxN | Palauttaa luettelon enimmäisarvot. Palautettavien arvojen määrä tai suodatusehto on määritettävä. |
List.Median | Palauttaa luettelon mediaaniarvon. |
List.Min | Palauttaa luettelon kohteiden vähimmäisarvon tai valinnaisen oletusarvon, jos luettelo on tyhjä. |
List.MinN | Palauttaa luettelon vähimmäisarvot. Palautettavien arvojen määrä tai suodatusehto voidaan määrittää. |
List.Sort | Palauttaa lajitellun luettelon käyttämällä vertailukriteeriä. |
List.Percentile | Palauttaa yhden tai useamman näyte prosenttipisteen, joka vastaa annettuja todennäköisyyksiä. |
Nämä funktiot toimivat homogeenisissa Numbers-, DateTimes- ja Durations-luetteloissa.
Nimi | Kuvaus |
---|---|
List.Average | Palauttaa luettelon keskiarvon luettelon arvojen tietotyyppinä. |
List.Mode | Palauttaa tietoyksikön, joka näkyy yleisimmin luettelossa. |
List.Modes | Palauttaa kaikki kohteet, jotka näkyvät samalla enimmäistaajuudella. |
List.StandardDeviation | Palauttaa arvoluettelon keskihajonnan. List.StandardDeviation suorittaa mallipohjaisen arvion. Tuloksena on lukujen luku sekä DateTimes- ja Durations-lukujen kesto. |
Nämä funktiot toimivat homogeenisissa Numbers- ja Durations-luetteloissa.
Nimi | Kuvaus |
---|---|
List.Sum | Palauttaa summan luettelosta. |
Nämä funktiot toimivat vain lukujen kohdalla.
Nimi | Kuvaus |
---|---|
List.Covariance | Palauttaa yhteisvarianssin kahdesta luettelosta lukuna. |
List.Product | Palauttaa tuotteen lukuluettelosta. |
Nämä funktiot luovat arvoluettelon.
Nimi | Kuvaus |
---|---|
List.Dates | Palauttaa päivämääräarvojen luettelon koon määrästä alusta alkaen ja lisää lisäyksen jokaiseen arvoon. |
List.DateTimes | Palauttaa päivämäärä- ja aika-arvojen luettelon koon määrästä alusta alkaen ja lisää lisäyksen jokaiseen arvoon. |
List.DateTimeZones | Palauttaa päivämäärä- ja aikavyöhykearvojen luettelon koon määrästä alusta alkaen ja lisää lisäyksen jokaiseen arvoon. |
List.Durations | Palauttaa kestoarvojen luettelon koon määrästä alusta alkaen ja lisää lisäyksen jokaiseen arvoon. |
List.Generate | Muodostaa arvoluettelon. |
List.Numbers | Palauttaa lukujen luettelon koon määrästä ensimmäisestä alkaen ja lisää lisäyksen. Lisäyksen oletusarvo on 1. |
List.Random | Palauttaa määrän satunnaislukujen luettelon, joka sisältää valinnaisen alkuarvoparametrin. |
List.Times | Palauttaa koon määrän aika-arvojen luettelon alusta alkaen. |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Ascending = 0;
- Order.Descending = 1;
Luetteloarvojen kaavaehdot voidaan määrittää joko seuraavasti:
- Funktioarvo, joka on joko:
- Avainvalitsin, joka määrittää luettelon arvon, jossa yhtäläisyysehtoja käytetään.
- Vertailutoimintofunktio, jonka avulla määritetään käytettävä vertailutyyppi. Sisäiset vertailutoimintofunktiot voidaan määrittää – siirry Comparer-funktioihin.
- luetteloarvo, jolla on:
- Täsmälleen kaksi kohdetta.
- Ensimmäinen elementti on edellä määritetty avainvalitsin.
- Toinen elementti on edellä määritetty vertailutoiminto.
Saat lisätietoja ja esimerkkejä artikkelista List.Distinct.
Vertailukriteeri voidaan antaa jommankumman seuraavista arvoista:
- Numeroarvona lajittelujärjestyksen määrittämiseksi. Jos haluat lisätietoja, siirry kohtaan Lajittelujärjestys-.
- Lajitteluun käytettävän avaimen laskemiseen voidaan käyttää yhden argumentin funktiota.
- Jos haluat valita sekä avaimen että hallintajärjestyksen, vertailukriteeri voi olla avaimen ja järjestyksen sisältävä luettelo.
- Vertailun täydelliseen hallintaan voidaan käyttää kahden argumentin funktiota, joka palauttaa arvon -1, 0 tai 1, kun otetaan huomioon vasemman- ja oikeanpuoleisten syötteiden välinen suhde. Value.Compare on menetelmä, jonka avulla tätä logiikkaa voidaan delegoida.
Saat lisätietoja ja esimerkkejä artikkelista List.Sort.
Korvaustoiminnot määritetään luetteloarvon mukaan. Luettelon jokaisen kohteen on oltava seuraava:
- Täsmälleen kahden kohteen luetteloarvo.
- Ensimmäinen kohde on luettelon vanha arvo, joka korvataan.
- Toinen kohde on uusi arvo, joka korvaa kaikki luettelon vanhan arvon esiintymät.