Luettelofunktiot

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

Informaatio

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

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

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.

Järjestys

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

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.

Parametriarvojen

Esiintymän määritys

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

Lajittelujärjestys

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

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

Vertailuehdot

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

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.