Lista över funktioner

Artikel
08/28/2023

Dessa funktioner skapar och ändrar listvärden.

Information

Namn	Beskrivning
List.Count	Returnerar antalet objekt i en lista.
List.NonNullCount	Returnerar antalet objekt i en lista exklusive null-värden
List.IsEmpty	Returnerar om en lista är tom.

Urval

Namn	Beskrivning
List.Alternate	Returnerar en lista med objekten alternerade från den ursprungliga listan baserat på antal, valfri repeatInterval och en valfri förskjutning.
List.Buffer	Buffrar listan i minnet. Resultatet av det här anropet är en stabil lista, vilket innebär att den har ett determinimiskt antal och ordningen på objekt.
List.Distinct	Filtrerar ned en lista genom att ta bort dubbletter. Ett valfritt ekvationsvillkorsvärde kan anges för att kontrollera likhetsjämförelse. Det första värdet från varje likhetsgrupp väljs.
List.FindText	Söker i en lista med värden, inklusive postfält, efter ett textvärde.
List.First	Returnerar det första värdet i listan eller det angivna standardvärdet om det är tomt. Returnerar det första objektet i listan, eller det valfria standardvärdet, om listan är tom. Om listan är tom och inget standardvärde har angetts returnerar funktionen.
List.FirstN	Returnerar den första uppsättningen objekt i listan genom att ange hur många objekt som ska returneras eller ett kvalificerande villkor som tillhandahålls av `countOrCondition`.
List.InsertRange	Infogar objekt från värden i det angivna indexet i indatalistan.
List.IsDistinct	Returnerar om en lista är distinkt.
List.Last	Returnerar den sista uppsättningen objekt i listan genom att ange hur många objekt som ska returneras eller ett kvalificerande villkor som tillhandahålls av `countOrCondition`.
List.LastN	Returnerar den sista uppsättningen objekt i en lista genom att ange hur många objekt som ska returneras eller ett kvalificerande villkor.
List.MatchesAll	Returnerar sant om alla objekt i en lista uppfyller ett villkor.
List.MatchesAny	Returnerar sant om ett objekt i en lista uppfyller ett villkor.
List.Positions	Returnerar en lista över positioner för en indatalista.
List.Range	Returnerar ett antal objekt som börjar vid en förskjutning.
List.Select	Väljer de objekt som matchar ett villkor.
List.Single	Returnerar det enskilda objektet i listan eller genererar ett `Expression.Error` om listan har fler än ett objekt.
List.SingleOrDefault	Returnerar ett enskilt objekt från en lista.
List.Skip	Hoppar över det första objektet i listan. Med en tom lista returneras en tom lista. Den här funktionen tar en valfri parameter `countOrCondition` som stöd för att hoppa över flera värden.

Transformeringsfunktioner

Namn	Beskrivning
List.Accumulate	Ackumulerar ett resultat från listan. Från det inledande värdeutsädet tillämpar den här funktionen ackumulatorfunktionen och returnerar slutresultatet.
List.Combine	Sammanfogar en lista med listor i en enda lista.
List.ConformToPageReader	Den här funktionen är endast avsedd för internt bruk.
List.RemoveRange	Returnerar en lista som tar bort antal objekt som börjar vid förskjutningen. Standardantalet är 1.
List.RemoveFirstN	Returnerar en lista med det angivna antalet element som tagits bort från listan från och med det första elementet. Antalet element som tas bort beror på den valfria `countOrCondition` parametern.
List.RemoveItems	Tar bort objekt från `list1` som finns i `list2`och returnerar en ny lista.
List.RemoveLastN	Returnerar en lista med det angivna antalet element som tagits bort från listan med början vid det sista elementet. Antalet element som tas bort beror på den valfria `countOrCondition` parametern.
List.Repeat	Returnerar en lista som upprepar innehållet i antalet indatalistor.
List.ReplaceRange	Returnerar en lista som ersätter antalsvärden i en lista med en `replaceWith` lista som börjar vid ett index.
List.RemoveMatchingItems	Tar bort alla förekomster av angivna värden i listan.
List.RemoveNulls	Tar bort null-värden från en lista.
List.ReplaceMatchingItems	Ersätter förekomster av befintliga värden i listan med nya värden med hjälp av angivna `equationCriteria`. Gamla och nya värden tillhandahålls av parametrarna `replacements` . Ett valfritt ekvationsvillkorsvärde kan anges för att kontrollera likhetsjämförelser. Mer information om ersättningsåtgärder och ekvationsvillkor finns i Parametervärden.
List.ReplaceValue	Söker i en lista med värden efter värdet och ersätter varje förekomst med ersättningsvärdet.
List.Reverse	Returnerar en lista som återför objekten i en lista.
List.Split	Delar upp den angivna listan i en lista med listor med den angivna sidstorleken.
List.Transform	Utför funktionen på varje objekt i listan och returnerar den nya listan.
List.TransformMany	Returnerar en lista vars element projiceras från indatalistan.

Medlemskapsfunktioner

Eftersom alla värden kan testas för likhet kan dessa funktioner köras över heterogena listor.

Namn	Beskrivning
List.AllTrue	Returnerar sant om alla uttryck i en lista är sanna
List.AnyTrue	Returnerar sant om något uttryck i en lista i true
List.Contains	Returnerar sant om ett värde hittas i en lista.
List.ContainsAll	Returnerar sant om alla objekt i värden hittas i en lista.
List.ContainsAny	Returnerar sant om ett objekt i värden hittas i en lista.
List.PositionOf	Hittar den första förekomsten av ett värde i en lista och returnerar dess position.
List.PositionOfAny	Hittar den första förekomsten av ett värde i värden och returnerar dess position.

Ange åtgärder

Namn	Beskrivning
List.Difference	Returnerar de objekt i lista 1 som inte visas i lista 2. Dubblettvärden stöds.
List.Intersect	Returnerar en lista från en lista med listor och korsar vanliga objekt i enskilda listor. Dubblettvärden stöds.
List.Union	Returnerar en lista från en lista med listor och delar objekten i de enskilda listorna. Den returnerade listan innehåller alla objekt i alla indatalistor. Duplicerade värden matchas som en del av unionen.
List.Zip	Returnerar en lista med listor som kombinerar objekt på samma position.

Ordna profiler

Beställningsfunktioner utför jämförelser. Alla värden som jämförs måste vara jämförbara med varandra. Det innebär att alla måste komma från samma datatyp (eller inkludera null, som alltid jämför de minsta). Annars kastas en Expression.Error .

Jämförbara datatyper är:

Antal
Varaktighet
Datum/tid
Text
Logiskt
Null

Namn	Beskrivning
List.Max	Returnerar det maximala objektet i en lista eller det valfria standardvärdet om listan är tom.
List.MaxN	Returnerar maxvärdena i listan. Antalet värden som ska returneras eller ett filtreringsvillkor måste anges.
List.Median	Returnerar medianobjektet från en lista.
List.Min	Returnerar det minsta objektet i en lista eller det valfria standardvärdet om listan är tom.
List.MinN	Returnerar minimivärdena i en lista. Antalet värden som ska returneras eller ett filtreringsvillkor kan anges.
List.Sort	Returnerar en sorterad lista med hjälp av jämförelsevillkor.
List.Percentil	Returnerar en eller flera exempelprocentiler som motsvarar de angivna sannolikheterna.

Genomsnitt

Dessa funktioner fungerar över homogena listor med tal, datetimes och varaktigheter.

Namn	Beskrivning
List.Average	Returnerar ett genomsnittligt värde från en lista i datatypen för värdena i listan.
List.Mode	Returnerar ett objekt som visas oftast i en lista.
List.Modes	Returnerar alla objekt som visas med samma maximala frekvens.
List.StandardDeviation	Returnerar standardavvikelsen från en lista med värden. List.StandardDeviation utför en exempelbaserad uppskattning. Resultatet är ett tal för tal och en varaktighet för DateTimes och Durations.

Tillägg

Dessa funktioner fungerar över homogena listor med tal eller varaktigheter.

Namn	Beskrivning
List.Sum	Returnerar summan från en lista.

Matematik

Dessa funktioner fungerar bara över siffror.

Namn	Beskrivning
List.Covariance	Returnerar kovariansen från två listor som ett tal.
List.Product	Returnerar produkten från en lista med tal.

Generatorer

Dessa funktioner genererar en lista med värden.

Namn	Beskrivning
List.Dates	Returnerar en lista med datumvärden från storleksantalet från början och lägger till en ökning till varje värde.
List.DateTimes	Returnerar en lista med datetime-värden från storleksantalet, som börjar vid start och lägger till en ökning till varje värde.
List.DateTimeZones	Returnerar en lista över datetimezone-värden från storleksantalet, som börjar vid start och lägger till ett steg i varje värde.
List.Durations	Returnerar en lista med varaktighetsvärden från storleksantalet från början och lägger till en ökning till varje värde.
List.Generate	Genererar en lista med värden.
List.Numbers	Returnerar en lista med tal från storleksantalet från början och lägger till en ökning. Inkrementet är standardvärdet 1.
List.Random	Returnerar en lista över antalet slumpmässiga tal med en valfri seed-parameter.
List.Times	Returnerar en lista över tidsvärden för antal storlekar, med början från början.

Parametervärden

Förekomstspecifikation

Sorteringsordning

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

Ekvationsvillkor

Ekvationsvillkor för listvärden kan anges som antingen:

Ett funktionsvärde som antingen är:
- En nyckelväljare som avgör värdet i listan för att tillämpa likhetskriterierna.
- En jämförelsefunktion som används för att ange vilken typ av jämförelse som ska tillämpas. Inbyggda jämförelsefunktioner kan anges – gå till Jämförelsefunktioner.
Ett listvärde som har:
- Exakt två objekt.
- Det första elementet är nyckelväljaren enligt ovan.
- Det andra elementet är en jämförelse som anges ovan.

Mer information och exempel finns i List.Distinct.

Jämförelsevillkor

Jämförelsevillkor kan anges som något av följande värden:

Ett talvärde för att ange en sorteringsordning. Mer information finns i Sorteringsordning.
För att beräkna en nyckel som ska användas för sortering kan en funktion av ett argument användas.
För att både välja en nyckel och kontrollordning kan jämförelsekriteriet vara en lista som innehåller nyckeln och ordningen.
För att helt kontrollera jämförelsen kan en funktion med två argument användas som returnerar -1, 0 eller 1 med tanke på relationen mellan vänster och höger indata. Value.Compare är en metod som kan användas för att delegera den här logiken.

Mer information och exempel finns i List.Sort.

Ersättningsåtgärder

Ersättningsåtgärder anges med ett listvärde. Varje objekt i den här listan måste vara:

Ett listvärde på exakt två objekt.
Det första objektet är det gamla värdet i listan som ska ersättas.
Det andra objektet är det nya värdet, som ska ersätta alla förekomster av det gamla värdet i listan.

Dela via