Läs på engelska

Dela via


Lista funktioner

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 som är alternerade från den ursprungliga listan baserat på ett antal, ett valfritt upprepningsintervall 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 en 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 där ett visst antal objekt tas bort med början från en angiven position. 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 list2och 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 en indatalista ett angivet antal gånger.
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 den 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 av listor enligt 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 är sant.
List.Contains Returnerar sant om ett värde hittas i en lista.
List.ContainsAll Returnerar sant om alla element i värden hittas i listan.
List.ContainsAny Returnerar sant om något i värden hittas i listan.
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 förenar elementen i de enskilda listorna. Den returnerade listan innehåller alla objekt i alla indatalistor. Duplicerade värden matchas i unionen.
List.Zip Returnerar en lista med listor som kombinerar objekt på samma position.

Beställning

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 utlöses en Expression.Error.

Jämförbara datatyper är:

  • Nummer
  • Varaktighet
  • DatumTid
  • Text
  • Logisk
  • Noll
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.Percentile Returnerar en eller flera exempelprocentiler som motsvarar de angivna sannolikheterna.

Medelvärden

Dessa funktioner fungerar över homogena listor med Tal, Datum och Tidpunkter, och Tidsperioder.

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 siffror och en varaktighet för datum och tidsperioder.

Addition

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

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

Numeriska värden

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 förinställt till 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

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.