Luettelofunktiot

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

Informaatio

Nimi	Kuvaus
List.Count	Palauttaa luettelon kohteiden määrän.
List.IsEmpty	Palauttaa true, jos luettelo on tyhjä.
List.NonNullCount	Palauttaa luettelon muiden kuin tyhjäarvoisten kohteiden määrän.

Valinta

Nimi	Kuvaus
List.Alternate	Palauttaa luettelon, joka muodostuu kaikista luettelon parittomista siirtymäelementeistä.
List.Buffer	Puskuroi luettelon.
List.Distinct	Palauttaa arvoluettelon, jonka kaksoiskappaleet on poistettu.
List.FindText	Palauttaa luettelon arvoista (mukaan lukien tietuekentät), jotka sisältävät määritetyn tekstin.
List.First	Palauttaa luettelon ensimmäisen arvon tai määritetyn oletusarvon, jos se on tyhjä.
List.FirstN	Palauttaa luettelon ensimmäisen kohdejoukon määrittämällä, montako kohdetta palautetaan, tai ehdon.
List.InsertRange	Lisää arvot luettelon annettuun indeksiin.
List.IsDistinct	Ilmaisee, onko luettelossa kaksoiskappaleita.
List.Last	Palauttaa luettelon viimeisen arvon tai määritetyn oletusarvon, jos se on tyhjä.
List.LastN	Palauttaa luettelon viimeisen arvon. Voi valinnaisesti määrittää, montako arvoa palautetaan, tai ehdon.
List.MatchesAll	Palauttaa true, jos kaikki luettelon arvot täyttävät ehtofunktion ehdot.
List.MatchesAny	Palauttaa true, jos jokin arvo täyttää ehtofunktion ehdot.
List.Positions	Palauttaa siirtymäluettelon syötteelle.
List.Range	Palauttaa luettelon alijoukon alkaen siirtymästä.
List.Select	Palauttaa ehtoa vastaavan arvoluettelon.
List.Single	Palauttaa yhden luettelon kohteesta, jonka pituus on yksi, ja muussa tapauksessa aiheuttaa poikkeuksen.
List.SingleOrDefault	Palauttaa yhden luettelon, jonka pituus on yksi, ja tyhjän luettelon oletusarvon.
List.Skip	Palauttaa luettelon, joka ohittaa määritetyn määrän elementtejä luettelon alussa.

Muunnosfunktiot

Nimi	Kuvaus
List.Accumulate	Palauttaa yhteenvetoarvon luettelon kohteista.
List.Combine	Palauttaa yksittäisen luettelon yhdistämällä useita luetteloita.
List.ConformToPageReader	Tämä funktio on tarkoitettu vain sisäiseen käyttöön.
List.RemoveFirstN	Palauttaa luettelon, joka ohittaa määritetyn määrän elementtejä luettelon alussa.
List.RemoveItems	Poistaa toisessa luettelossa olevat kohteet ensimmäisestä luettelosta.
List.RemoveLastN	Palauttaa luettelon, joka poistaa määritetyn määrän elementtejä luettelon lopusta.
List.RemoveMatchingItems	Poistaa kaikki syötearvojen esiintymät.
List.RemoveNulls	Poistaa kaikki null arvot määritetystä luettelosta.
List.RemoveRange	Poistaa arvojen määrän aloittaen määritetystä sijainnista.
List.Repeat	Palauttaa luettelon, joka count toistoa alkuperäisestä luettelosta.
List.ReplaceMatchingItems	Korvaa luettelon olemassa olevien arvojen esiintymät uusilla arvoilla, jotka vastaavat ehtoa.
List.ReplaceRange	Korvaa count arvojen määrän alkaen kohdasta position korvaavalla arvolla.
List.ReplaceValue	Hakee määritetyn arvon luettelosta ja korvaa sen.
List.Reverse	Tekee luettelon arvojen järjestyksestä käänteisen.
List.Split	Jakaa määritetyn luettelon luetteloiden luetteloksi käyttäen määritettyä sivun kokoa.
List.Transform	Palauttaa uuden tästä luettelosta laskettujen arvojen luettelon.
List.TransformMany	Palauttaa luettelon, jonka elementit muunnetaan syöteluettelosta määritettyjen funktioiden avulla.
List.Zip	Palauttaa luetteloiden luettelon yhdistämällä samassa sijainnissa olevat kohteet useissa luetteloissa.

Jäsenyysfunktiot

Koska kaikkien arvojen yhdenvertaisuus voidaan testata, nämä funktiot voidaan suorittaa heterogeenisille luetteloille.

Nimi	Kuvaus
List.AllTrue	Palauttaa true, jos kaikkien lausekkeiden arvo on tosi.
List.AnyTrue	Palauttaa arvon true, jos millä tahansa lausekkeella on arvo tosi.
List.Contains	Ilmaisee, sisältääkö luettelo arvon.
List.ContainsAll	Ilmaisee, mihin luettelo sisältää kaikki toisen luettelon arvot.
List.ContainsAny	Ilmaisee, minne luettelo sisältää minkä tahansa toisen luettelon arvoista.
List.PositionOf	Palauttaa luettelon arvon siirtymät.
List.PositionOfAny	Palauttaa luettelon arvon ensimmäisen siirtymän.

Toimintojen määrittäminen

Nimi	Kuvaus
List.Difference	Palauttaa kahden annetun luettelon eron.
List.Intersect	Palauttaa syötteestä löydettyjen luetteloarvojen leikkauskohdan.
List.Union	Palauttaa syötteestä löydettyjen luetteloarvojen liitoksen.

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 tyhjän luettelon enimmäisarvon tai oletusarvon.
List.MaxN	Palauttaa luettelon enimmäisarvot. Palautettavien arvojen määrä tai suodatusehto on määritettävä.
List.Median	Palauttaa luettelon mediaaniarvon.
List.Min	Palauttaa tyhjän luettelon vähimmäisarvon tai oletusarvon.
List.MinN	Palauttaa luettelon vähimmäisarvon tai -arvot. Palautettavien arvojen määrä tai suodatusehto voidaan määrittää.
List.Sort	Lajittelee tietoluettelon määritettyjen ehtojen mukaan.
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 arvojen keskiarvon. Toimii luku-, päivämäärä-, päivämäärä/aika-, päivämäärä/aikavyöhyke- ja kestoarvojen kanssa.
List.Mode	Palauttaa luettelon yleisimmän arvon.
List.Modes	Palauttaa luettelon yleisimmistä arvoista.
List.StandardDeviation	Palauttaa mallipohjaisen arvion keskihajonnasta. Tämä funktio 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 luettelon kohteiden summan.

Numeeriset arvot

Nämä funktiot toimivat vain lukujen kohdalla.

Nimi	Kuvaus
List.Covariance	Palauttaa kahden lukuluettelon välisen kovarianssin.
List.Product	Palauttaa luettelon lukujen tuloksen.

Generaattorit

Nämä funktiot luovat arvoluettelon.

Nimi	Kuvaus
List.Dates	Muodostaa luettelon date arvoista, kun annetaan alkuarvo, määrä ja lisäävä kestoarvo.
List.DateTimes	Muodostaa luettelon datetime arvoista, kun annetaan alkuarvo, määrä ja lisäävä kestoarvo.
List.DateTimeZones	Muodostaa luettelon datetimezone arvoista, kun annetaan alkuarvo, määrä ja lisäävä kestoarvo.
List.Durations	Muodostaa luettelon duration arvoista, kun annetaan alkuarvo, määrä ja lisäävä kestoarvo.
List.Generate	Muodostaa arvoluettelon.
List.Numbers	Palauttaa lukuluettelon, kun annetaan alkuarvo, määrä ja valinnainen lisäysarvo.
List.Random	Palauttaa satunnaislukujen luettelon.
List.Times	Muodostaa luettelon time arvoista, kun annetaan alkuarvo, määrä ja lisäävä kestoarvo.

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.