Del via

Listefunksjoner

  • Artikkel

Disse funksjonene oppretter og manipulerer listeverdier.

Informasjon

Navn Beskrivelse
List.Count Returnerer antall elementer i en liste.
List.IsEmpty Returnerer true hvis listen er tom.
List.NonNullCount Returnerer antall elementer som ikke er null i listen.

Utvalg

Navn Beskrivelse
List.Alternate Returnerer en liste bestående av alle oddetallsforskyvningselementene i en liste.
List.Buffer Bufrer en liste.
List.Distinct Returnerer en liste over verdier med duplikater fjernet.
List.FindText Returnerer en liste over verdier (inkludert postfelt) som inneholder den angitte teksten.
List.First Returnerer den første verdien i listen eller den angitte standardverdien hvis den er tom.
List.FirstN Returnerer det første settet med elementer i listen ved å angi hvor mange elementer som skal returneres eller en kvalifiserende betingelse.
List.InsertRange Setter inn verdier i en liste ved den angitte indeksen.
List.IsDistinct Angir om det finnes duplikater i listen.
List.Last Returnerer den siste verdien i listen eller den angitte standardverdien hvis den er tom.
List.LastN Returnerer den siste verdien i listen. Kan eventuelt angi hvor mange verdier som skal returneres eller en kvalifiserende betingelse.
List.MatchesAll Returnerer true hvis betingelsesfunksjonen er fornøyd med alle verdiene i listen.
List.MatchesAny Returnerer true hvis betingelsesfunksjonen er fornøyd med en verdi.
List.Positions Returnerer en liste over forskyvninger for inndataene.
List.Range Returnerer et delsett av listen som begynner med en forskyvning.
List.Select Returnerer en liste over verdier som samsvarer med betingelsen.
List.Single Returnerer det ene listeelementet for en liste med lengde én, ellers kaster et unntak.
List.SingleOrDefault Returnerer det ene listeelementet for en liste med lengde én og standardverdien for en tom liste.
List.Skip Returnerer en liste som hopper over det angitte antallet elementer i begynnelsen av listen.

Transformasjonsfunksjoner

Navn Beskrivelse
List.Accumulate AAccumulates en sammendragsverdi fra elementene i listen.
List.Combine Returnerer én enkelt liste ved å kombinere flere lister.
List.ConformToPageReader Denne funksjonen er bare ment for intern bruk.
List.RemoveFirstN Returnerer en liste som hopper over det angitte antallet elementer i begynnelsen av listen.
List.RemoveItems Fjerner elementer fra den første listen som finnes i den andre listen.
List.RemoveLastN Returnerer en liste som fjerner det angitte antallet elementer fra slutten av listen.
List.RemoveMatchingItems Fjerner alle forekomster av inndataverdiene.
List.RemoveNulls Fjerner alle null verdier fra den angitte listen.
List.RemoveRange Fjerner antall verdier som starter på den angitte posisjonen.
List.Repeat Returnerer en liste som er count repetisjoner av den opprinnelige listen.
List.ReplaceMatchingItems Erstatter forekomster av eksisterende verdier i listen med nye verdier som samsvarer med betingelsen.
List.ReplaceRange Erstatter count antall verdier som starter på position med erstatningsverdiene.
List.ReplaceValue Søker i en liste etter den angitte verdien og erstatter den.
List.Reverse Reverserer rekkefølgen på verdiene i listen.
List.Split Deler den angitte listen inn i en liste over lister ved hjelp av den angitte sidestørrelsen.
List.Transform Returnerer en ny liste med verdier beregnet fra denne listen.
List.TransformMany Returnerer en liste med elementer som er transformert fra inndatalisten ved hjelp av angitte funksjoner.
List.Zip Returnerer en liste over lister ved å kombinere elementer i samme posisjon i flere lister.

Medlemskapsfunksjoner

Siden alle verdier kan testes for likhet, kan disse funksjonene operere over heterogene lister.

Navn Beskrivelse
List.AllTrue Returnerer true hvis alle uttrykkene er sanne.
List.AnyTrue Returnerer sann hvis et uttrykk er sant.
List.Contains Angir om listen inneholder verdien.
List.ContainsAll Angir hvor en liste inneholder alle verdiene i en annen liste.
List.ContainsAny Angir hvor en liste inneholder noen av verdiene i en annen liste.
List.PositionOf Returnerer forskyvningen(e) til en verdi i en liste.
List.PositionOfAny Returnerer den første forskyvningen av en verdi i en liste.

Angi operasjoner

Navn Beskrivelse
List.Difference Returnerer forskjellen mellom de to gitte listene.
List.Intersect Returnerer skjæringspunktet mellom listeverdiene som finnes i inndataene.
List.Union Returnerer unionen av listeverdiene som ble funnet i inndataene.

Bestilling

Bestillingsfunksjoner utfører sammenligninger. Alle verdier som sammenlignes, må være sammenlignbare med hverandre. Dette betyr at alle må komme fra samme datatype (eller inkludere null, som alltid sammenligner minste). Ellers blir det kastet en Expression.Error.

Sammenlignbare datatyper inkluderer:

  • Nummer
  • Varighet
  • DateTime
  • Tekst
  • Logisk
  • Null
Navn Beskrivelse
List.Max Returnerer maksimumsverdien eller standardverdien for en tom liste.
List.MaxN Returnerer maksimumsverdien(e) i listen. Antall verdier som skal returneres eller en filtreringsbetingelse må angis.
List.Median Returnerer medianverdien i listen.
List.Min Returnerer minimumsverdien eller standardverdien for en tom liste.
List.MinN Returnerer minimumsverdien(e) i listen. Antall verdier som skal returneres eller en filtreringsbetingelse kan angis.
List.Sort Sorterer en liste med data i henhold til vilkårene som er angitt.
List.Percentile Returnerer én eller flere eksempelprosentiler som tilsvarer de angitte sannsynlighetene.

Gjennomsnitt

Disse funksjonene fungerer over homogene lister over tall, datetimes og varigheter.

Navn Beskrivelse
List.Average Returnerer gjennomsnittet av verdiene. Fungerer med tall-, dato-, datetime-, datetimezone- og varighetsverdier.
List.Mode Returnerer den hyppigste verdien i listen.
List.Modes Returnerer en liste over de hyppigste verdiene i listen.
List.StandardDeviation Returnerer et eksempelbasert estimat av standardavviket. Denne funksjonen utfører et eksempelbasert estimat. Resultatet er et tall for tall, og en varighet for DateTimes og Durations.

Addisjon

Disse funksjonene fungerer over homogene lister over tall eller varigheter.

Navn Beskrivelse
List.Sum Returnerer summen av elementene i listen.

Numeriske tall

Disse funksjonene fungerer bare over tall.

Navn Beskrivelse
List.Covariance Returnerer kovariansen mellom de to listene med tall.
List.Product Returnerer produktet av tallene i listen.

Generatorer

Disse funksjonene genererer en liste over verdier.

Navn Beskrivelse
List.Dates Genererer en liste over date verdier gitt en startverdi, antall og trinnvis varighetsverdi.
List.DateTimes Genererer en liste over datetime verdier gitt en startverdi, antall og trinnvis varighetsverdi.
List.DateTimeZones Genererer en liste over datetimezone verdier gitt en startverdi, antall og trinnvis varighetsverdi.
List.Durations Genererer en liste over duration verdier gitt en startverdi, antall og trinnvis varighetsverdi.
List.Generate Genererer en liste over verdier.
List.Numbers Returnerer en liste med tall gitt en startverdi, antall og valgfri økningsverdi.
List.Random Returnerer en liste over tilfeldige tall.
List.Times Genererer en liste over time verdier gitt en startverdi, antall og trinnvis varighetsverdi.

Parameterverdier

Forekomstspesifikasjon

Sorteringsrekkefølge

Formelvilkår

Formelvilkår for listeverdier kan angis som enten:

  • En funksjonsverdi som er enten:
    • En nøkkelvelger som bestemmer verdien i listen for å bruke likhetskriteriene.
    • En sammenligningsfunksjon som brukes til å angi hvilken type sammenligning som skal brukes. Innebygde sammenligningsfunksjoner kan angis – gå til Comparer-funksjoner.
  • En listeverdi som har:
    • Nøyaktig to elementer.
    • Det første elementet er nøkkelvelgeren som angitt ovenfor.
    • Det andre elementet er en sammenligning som angitt ovenfor.

Hvis du vil ha mer informasjon og eksempler, kan du gå til List.Distinct.

Sammenligningskriterier

Sammenligningskriteriet kan angis som en av følgende verdier:

  • En tallverdi for å angi en sorteringsrekkefølge. Hvis du vil ha mer informasjon, kan du gå til Sorteringsrekkefølge.
  • Hvis du vil beregne en nøkkel som skal brukes til sortering, kan du bruke en funksjon med ett argument.
  • For både å velge en nøkkel- og kontrollrekkefølge kan sammenligningskriteriet være en liste som inneholder nøkkelen og rekkefølgen.
  • Hvis du vil kontrollere sammenligningen fullstendig, kan du bruke en funksjon med to argumenter som returnerer -1, 0 eller 1, gitt relasjonen mellom venstre og høyre inndata. Value.Compare er en metode som kan brukes til å delegere denne logikken.

Hvis du vil ha mer informasjon og eksempler, kan du gå til List.Sort.

Erstatningsoperasjoner

Erstatningsoperasjoner angis av en listeverdi. Hvert element i denne listen må være:

  • En listeverdi med nøyaktig to elementer.
  • Det første elementet er den gamle verdien i listen som skal erstattes.
  • Det andre elementet er den nye verdien, som skal erstatte alle forekomster av den gamle verdien i listen.