Dela via

Lista funktioner

  • Artikel

Dessa funktioner skapar och ändrar listvärden.

Information

Namn Beskrivning
List.Count Returnerar antalet objekt i en lista.
List.IsEmpty Returnerar true om listan är tom.
List.NonNullCount Returnerar antalet icke-null-objekt i listan.

Urval

Namn Beskrivning
List.Alternate Returnerar en lista som består av alla udda numrerade förskjutningselement i en lista.
List.Buffer Buffrar en lista.
List.Distinct Returnerar en lista med värden med dubbletter borttagna.
List.FindText Returnerar en lista med värden (inklusive postfält) som innehåller den angivna texten.
List.First Returnerar det första värdet i listan eller det angivna standardvärdet om det är tomt.
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.
List.InsertRange Infogar värden i en lista i det angivna indexet.
List.IsDistinct Anger om det finns dubbletter i listan.
List.Last Returnerar det sista värdet i listan eller det angivna standardvärdet om det är tomt.
List.LastN Returnerar det sista värdet i listan. Kan också ange hur många värden som ska returneras eller ett kvalificerande villkor.
List.MatchesAll Returnerar true om villkorsfunktionen uppfylls av alla värden i listan.
List.MatchesAny Returnerar true om villkorsfunktionen uppfylls av något värde.
List.Positions Returnerar en lista över förskjutningar för indata.
List.Range Returnerar en delmängd av listan som börjar vid en förskjutning.
List.Select Returnerar en lista med värden som matchar villkoret.
List.Single Returnerar ett listobjekt för en lista med längd ett, annars genereras ett undantag.
List.SingleOrDefault Returnerar ett listobjekt för en lista med längd ett och standardvärdet för en tom lista.
List.Skip Returnerar en lista som hoppar över det angivna antalet element i början av listan.

Transformeringsfunktioner

Namn Beskrivning
List.Accumulate Ackumulerar ett sammanfattningsvärde från sakerna i listan.
List.Combine Returnerar en enskild lista genom att kombinera flera listor.
List.ConformToPageReader Den här funktionen är endast avsedd för internt bruk.
List.RemoveFirstN Returnerar en lista som hoppar över det angivna antalet element i början av listan.
List.RemoveItems Tar bort objekt från den första listan som finns i den andra listan.
List.RemoveLastN Returnerar en lista som tar bort det angivna antalet element från slutet av listan.
List.RemoveMatchingItems Tar bort alla förekomster av indatavärdena.
List.RemoveNulls Tar bort alla null värden från den angivna listan.
List.RemoveRange Tar bort antal värden som börjar på den angivna positionen.
List.Repeat Returnerar en lista som är count upprepningar av den ursprungliga listan.
List.ReplaceMatchingItems Ersätter förekomster av befintliga värden i listan med nya värden som matchar villkoret.
List.ReplaceRange Ersätter count antal värden som börjar vid position med ersättningsvärdena.
List.ReplaceValue Söker i en lista efter det angivna värdet och ersätter det.
List.Reverse Ändrar ordning på värden i listan.
List.Split Delar upp den angivna listan i en lista av listor enligt den angivna sidstorleken.
List.Transform Returnerar en ny lista med värden som beräknas från den här listan.
List.TransformMany Returnerar en lista vars element transformeras från indatalistan med hjälp av angivna funktioner.
List.Zip Returnerar en lista med listor genom att kombinera objekt på samma plats i flera listor.

Medlemskapsfunktioner

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

Namn Beskrivning
List.AllTrue Returnerar true om alla uttryck är sanna.
List.AnyTrue Returnerar sant om något uttryck är sant.
List.Contains Anger om listan innehåller värdet.
List.ContainsAll Anger var en lista innehåller alla värden i en annan lista.
List.ContainsAny Anger var en lista innehåller något av värdena i en annan lista.
List.PositionOf Returnerar förskjutningarna för ett värde i en lista.
List.PositionOfAny Returnerar den första förskjutningen av ett värde i en lista.

Ange åtgärder

Namn Beskrivning
List.Difference Returnerar skillnaden mellan de två givna listorna.
List.Intersect Returnerar skärningspunkten för listvärdena som finns i indata.
List.Union Returnerar union av listvärdena som finns i indata.

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 värdet eller standardvärdet för en tom lista.
List.MaxN Returnerar de maximala värdena i listan. Antalet värden som ska returneras eller ett filtreringsvillkor måste anges.
List.Median Returnerar medianvärdet i listan.
List.Min Returnerar minimivärdet eller standardvärdet för en tom lista.
List.MinN Returnerar de minsta värdena i listan. Antalet värden som ska returneras eller ett filtreringsvillkor kan anges.
List.Sort Sorterar en lista med data enligt de angivna kriterierna.
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 medelvärdet av värdena. Fungerar med värden för tal, datum, datumtid, datumtidszon och varaktighet.
List.Mode Returnerar det vanligaste värdet i listan.
List.Modes Returnerar en lista över de vanligaste värdena i listan.
List.StandardDeviation Returnerar en exempelbaserad uppskattning av standardavvikelsen. Den här funktionen 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 av objekten i listan.

Numeriska värden

Dessa funktioner fungerar bara över siffror.

Namn Beskrivning
List.Covariance Returnerar kovariansen mellan de två listorna med tal.
List.Product Returnerar produkten av talen i listan.

Generatorer

Dessa funktioner genererar en lista med värden.

Namn Beskrivning
List.Dates Genererar en lista över date värden med ett initialt värde, antal och inkrementellt varaktighetsvärde.
List.DateTimes Genererar en lista över datetime värden med ett initialt värde, antal och inkrementellt varaktighetsvärde.
List.DateTimeZones Genererar en lista över datetimezone värden med ett initialt värde, antal och inkrementellt varaktighetsvärde.
List.Durations Genererar en lista över duration värden med ett initialt värde, antal och inkrementellt varaktighetsvärde.
List.Generate Genererar en lista med värden.
List.Numbers Returnerar en lista med tal med ett initialt värde, antal och valfritt inkrementsvärde.
List.Random Returnerar en lista med slumpmässiga tal.
List.Times Genererar en lista över time värden med ett initialt värde, antal och inkrementellt varaktighetsvärde.

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.