Jaa

Luettelotoiminnot

  • Artikkeli

Nämä funktiot luovat ja käsittelevät luetteloarvoja.

Tietoja

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ä.

Valinta

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 countOrConditionon antanut .
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 countOrConditionon antanut .
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 palauttaa kohteen , 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 parametri countOrCondition , joka tukee useiden arvojen ohittamista.

Muunnosfunktiot

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 kohteet ,:ssä olevista list2kohteista 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 luettelolla replaceWith 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 .-parametria 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.

Jäsenyysfunktiot

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.

Toimintojen määrittäminen

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.

Tilaaminen

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 heitetään Expression.Error .

Vertailukelpoisia tietotyyppejä ovat seuraavat:

  • Luku
  • Kesto
  • DateTime
  • Teksti
  • Looginen
  • Tyhjäarvo
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ä.

Keskiarvot

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.

Yhteenlasku

Nämä funktiot toimivat homogeenisissa Numbers- ja Durations-luetteloissa.

Nimi Kuvaus
List.Sum Palauttaa summan luettelosta.

Numeeriset arvot

Nämä funktiot toimivat vain lukujen kohdalla.

Nimi Kuvaus
List.Covariance Palauttaa yhteisvarianssin kahdesta luettelosta lukuna.
List.Product Palauttaa tuotteen lukuluettelosta.

Generaattorit

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.

Parametrin arvot

Esiintymän määritys

Lajittelujärjestys

Kaavaehdot

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. Valmiita vertailutoimintofunktioita voidaan määrittää – siirry vertailutoimintofunktioihin.
  • 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ä siirtymällä kohtaan List.Distinct.

Vertailuehdot

Vertailukriteeri voidaan antaa jommankumman seuraavista arvoista:

  • Numeroarvona lajittelujärjestyksen määrittämiseksi. Lisätietoja on kohdassa 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

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.