Függvények listázása

Ezek a függvények listaértékeket hoznak létre és kezelnek.

Információ

Név Leírás
List.Count A lista elemeinek számát adja vissza.
List.IsEmpty Visszaadja a true értéket, ha a lista üres.
List.NonNullCount A lista nem null értékű elemeinek számát adja vissza.

Szelekció

Név Leírás
List.Alternate Egy listát ad vissza, amely az összes páratlan sorszámú elemet tartalmazza egy listából.
List.Buffer Lista pufferelése.
List.Distinct Visszaad egy listát az ismétlődő elemek nélkül.
List.FindText Visszaadja a megadott szöveget tartalmazó értékek listáját (a rekordmezőket is beleértve).
List.First A lista első értékét adja vissza, vagy a megadott alapértelmezett értéket, ha üres.
List.FirstN A lista első elemkészletét adja vissza a visszaadni kívánt elemek számának vagy egy megfelelő feltételnek a megadásával.
List.InsertRange Értékeket szúr be egy listába az adott indexen.
List.IsDistinct Azt jelzi, hogy vannak-e ismétlődő elemek a listában.
List.Last A lista utolsó értékét adja vissza, vagy a megadott alapértelmezett értéket, ha üres.
List.LastN A megadott lista utolsó elemének vagy elemeinek listáját adja vissza. Megadható, hogy hány értéket kell visszaadni, vagy egy megfelelő feltételt.
List.MatchesAll true ad vissza, ha a feltételfüggvényt a listában szereplő összes érték kielégíti.
List.MatchesAny true ad vissza, ha a feltételfüggvényt bármilyen érték kielégíti.
List.Positions A bemenet eltolásainak listáját adja vissza.
List.Range A lista egy eltolástól kezdődő részhalmazát adja vissza.
List.Select A feltételnek megfelelő értékek listáját adja vissza.
List.Single Egy listaelem értékét adja vissza egy hosszú lista esetében, máskülönben hibát jelez.
List.SingleOrDefault Egy egyetlen elemet tartalmazó lista esetén visszaadja annak az egy elemnek az értékét, míg egy üres lista esetén az alapértelmezett értéket adja vissza.
List.Skip Olyan listát ad vissza, amely kihagyja a lista elején megadott számú elemet.

Átalakítási függvények

Név Leírás
List.Accumulate Az AAccumulates összegzi a lista elemeinek értékeit.
List.Combine Egyetlen listát ad vissza több lista kombinálásával.
List.ConformToPageReader Ez a függvény kizárólag belső használatra van.
List.RemoveFirstN Olyan listát ad vissza, amely kihagyja a lista elején megadott számú elemet.
List.RemoveItems Eltávolítja a második listában szereplő elemeket az első listából.
List.RemoveLastN Egy listát ad vissza, amely eltávolítja a megadott számú elemet a lista végéről.
List.RemoveMatchingItems Eltávolítja a bemeneti értékek összes előfordulását.
List.RemoveNulls Eltávolítja az összes null értéket a megadott listából.
List.RemoveRange A megadott pozíciótól kezdődő értékek számának eltávolítása.
List.Repeat Olyan listát ad vissza, amely count-szor ismétli meg az eredeti listát.
List.ReplaceMatchingItems A lista meglévő értékeinek előfordulásait a feltételnek megfelelő új értékekre cseréli.
List.ReplaceRange A count időponttól kezdődő position értékeket lecseréli a helyettesítő értékekre.
List.ReplaceValue Megkeresi a megadott értéket, és lecseréli azt.
List.Reverse Megfordítja a lista értékeinek sorrendjét.
List.Split A megadott listát felosztja a megadott oldalméretet használó listák listájára.
List.Transform A listából kiszámított értékek új listáját adja vissza.
List.TransformMany Olyan listát ad vissza, amelynek elemei a megadott függvények használatával lesznek átalakítva a bemeneti listából.
List.Zip Egy listalistát ad vissza, ha több listában azonos helyen lévő elemeket kombinál.

Tagsági függvények

Mivel minden érték tesztelhető az egyenlőség szempontjából, ezek a függvények heterogén listákon is működhetnek.

Név Leírás
List.AllTrue true ad vissza, ha az összes kifejezés igaz.
List.AnyTrue Igaz értéket ad vissza, ha bármely kifejezés igaz.
List.Contains Azt jelzi, hogy a lista tartalmazza-e az értéket.
List.ContainsAll Azt jelzi, hogy egy lista hol tartalmazza egy másik listában szereplő összes értéket.
List.ContainsAny Azt jelzi, hogy egy lista hol tartalmazza egy másik listában szereplő értékek bármelyikét.
List.PositionOf Egy listában szereplő érték eltolásait adja vissza.
List.PositionOfAny Egy lista egyik értékének első eltolását adja vissza.

Műveletek beállítása

Név Leírás
List.Difference A két megadott lista különbségét adja vissza.
List.Intersect A bemenetben található listaértékek metszetét adja vissza.
List.Union A bemenetben található listaértékek egyesítését adja vissza.

Rendelés

A rendezési függvények összehasonlítást végeznek. Az összes összehasonlított értéknek összehasonlíthatónak kell lennie egymással. Ez azt jelenti, hogy mindegyiknek ugyanabból az adattípusból kell származnia (vagy null értéket kell tartalmaznia, amely mindig a legkisebbet hasonlítja össze). Ellenkező esetben egy Expression.Error fel van emelve.

Hasonló adattípusok a következők:

  • Szám
  • Időtartam
  • DátumIdő
  • Szöveg
  • Logikus
  • Nulla
Név Leírás
List.Max Egy üres lista maximális vagy alapértelmezett értékét adja vissza.
List.MaxN A listában szereplő maximális értéket adja vissza. Meg kell adni a visszaadni kívánt értékek számát vagy egy szűrőfeltételt.
List.Median A listában szereplő mediánértéket adja vissza.
List.Min Egy üres lista minimális vagy alapértelmezett értékét adja vissza.
List.MinN A lista minimális értékét adja vissza. Megadható a visszaadandó értékek száma vagy egy szűrőfeltétel.
List.Sort Az adatok listáját a megadott feltételek szerint rendezi.
List.Percentile Egy vagy több, a megadott valószínűségnek megfelelő minta percentilist ad vissza.

Átlagok

Ezek a függvények a Számok, a DateTimes és az Időtartamok homogén listáin működnek.

Név Leírás
List.Average Az értékek átlagát adja vissza. Szám-, dátum-, dátumidő-, dátumidőzóna- és időtartamértékekkel dolgozik.
List.Mode A lista leggyakoribb értékét adja vissza.
List.Modes A lista leggyakoribb értékeinek listáját adja vissza.
List.StandardDeviation A szórás mintaalapú becslését adja vissza. Ez a függvény mintaalapú becslést végez. Az eredmény egy szám a számokhoz, és egy időtartam a DateTime-ekhez és az időtartamokhoz.

Összeadás

Ezek a függvények számok vagy időtartamok homogén listáin működnek.

Név Leírás
List.Sum A lista elemeinek összegét adja vissza.

Numerikus

Ezek a függvények csak számokon működnek.

Név Leírás
List.Covariance A két számlista közötti kovariancia értékét adja vissza.
List.Product A listában szereplő számok szorzatát adja vissza.

Generátorok

Ezek a függvények értéklistát hoznak létre.

Név Leírás
List.Dates A kezdeti érték, a darabszám és a növekményes időtartamérték alapján date értékek listáját hozza létre.
List.DateTimes A kezdeti érték, a darabszám és a növekményes időtartamérték alapján datetime értékek listáját hozza létre.
List.DateTimeZones A kezdeti érték, a darabszám és a növekményes időtartamérték alapján datetimezone értékek listáját hozza létre.
List.Durations A kezdeti érték, a darabszám és a növekményes időtartamérték alapján duration értékek listáját hozza létre.
List.Generate Értéklistát hoz létre.
List.Numbers A kezdeti értéket, a darabszámot és az opcionális növekményes értéket tartalmazó számlistát adja vissza.
List.Random Véletlenszerű számok listáját adja eredményül.
List.Times A kezdeti érték, a darabszám és a növekményes időtartamérték alapján time értékek listáját hozza létre.

Paraméterértékek

Előfordulási specifikáció

Rendezési sorrend

Egyenletfeltételek

A listafüggvények közül sokban a equationCriteria paraméter azt jelzi, hogyan határozható meg az egyenlőség a listaelemek között. A listaértékek egyenletfeltétele a következőképpen adható meg:

  • Olyan függvényérték, amely az alábbi lehetőségek egyike:
    • Egy kulcsválasztó, amely meghatározza a listában szereplő értéket az egyenlőségi feltételek alkalmazásához.
    • Egy összehasonlító függvény, amely az alkalmazandó összehasonlítás típusának megadására szolgál. A beépített összehasonlító függvények megadhatók – lépjen a Comparer függvények elemre.
  • Listaérték, amely az alábbiakat tartalmazza:
    • Pontosan két elem.
    • Az első elem a fent megadott kulcsválasztó.
    • A második elem a fent megadott összehasonlító.

A legtöbb listafüggvényben a paraméterben equationCriteria használt összehasonlító függvénynek a beépített összehasonlító függvények egyikének kell lennie. Ezekben a listafüggvényekben az egyéni összehasonlító használata hibát eredményez. A következő lista függvények lehetővé teszik egy egyéni összehasonlító használatát:

További információkért és példákért keresse fel a List.Distinct és List.PositionOf.

Összehasonlítási feltételek

Az összehasonlítási feltétel az alábbi értékek valamelyikeként adható meg:

  • Számérték a rendezési sorrend megadásához. További információért látogasson el a Rendezési sorrendoldalra.
  • A rendezéshez használandó kulcs kiszámításához egy argumentum függvénye használható.
  • A kulcs és a vezérlési sorrend kiválasztásához az összehasonlítási feltétel lehet a kulcsot és a sorrendet tartalmazó lista.
  • Az összehasonlítás teljes szabályozásához két argumentumból álló függvény használható, amelyek -1, 0 vagy 1 értéket adnak vissza a bal és a jobb oldali bemenetek közötti kapcsolat alapján. Value.Compare egy metódus, amellyel delegálhatja ezt a logikát.

További információkért és példákért látogasson el a List.Sort.

Csereműveletek

A csereműveleteket listaérték határozza meg. A lista minden elemének a következőnek kell lennie:

  • Pontosan két elemnek a listaértéke.
  • Az első elem a lecserélendő régi érték a listában.
  • A második elem az új érték, amely a régi érték összes előfordulását lecseréli a listában.
  • Last updated on