Les på engelsk

Del via


Listefunksjoner

Disse funksjonene oppretter og manipulerer listeverdier.

Informasjon

Navn Beskrivelse
List.Count Returnerer antall elementer i en liste.
List.NonNullCount Returnerer antall elementer i en liste, unntatt nullverdier
List.IsEmpty Returnerer om en liste er tom.

Utvalg

Navn Beskrivelse
List.Alternate Returnerer en liste med elementene vekslet fra den opprinnelige listen basert på antall, valgfri repeatInterval og en valgfri forskyvning.
List.Buffer Bufrer listen i minnet. Resultatet av dette kallet er en stabil liste, noe som betyr at det vil ha en determinimisk telling og rekkefølgen på elementer.
List.Distinct Filtrerer en liste ned ved å fjerne duplikater. Du kan angi en valgfri formelkriterieverdi for å kontrollere likhetssammenligning. Den første verdien fra hver likhetsgruppe velges.
List.FindText Søker i en liste over verdier, inkludert postfelt, etter en tekstverdi.
List.First Returnerer den første verdien i listen eller den angitte standardverdien hvis den er tom. Returnerer det første elementet i listen, eller den valgfrie standardverdien, hvis listen er tom. Hvis listen er tom og en standardverdi ikke er angitt, returnerer funksjonen.
List.FirstN Returnerer det første settet med elementer i listen ved å angi hvor mange elementer som skal returneres eller en kvalifiserende betingelse angitt av countOrCondition.
List.InsertRange Setter inn elementer fra verdier i den angitte indeksen i inndatalisten.
List.IsDistinct Returnerer om en liste er distinkt.
List.Last Returnerer det siste settet med elementer i listen ved å angi hvor mange elementer som skal returneres eller en kvalifiserende betingelse angitt av countOrCondition.
List.LastN Returnerer det siste settet med elementer i en liste ved å angi hvor mange elementer som skal returneres eller en kvalifiserende betingelse.
List.MatchesAll Returnerer sann hvis alle elementer i en liste oppfyller en betingelse.
List.MatchesAny Returnerer sann hvis et element i en liste oppfyller en betingelse.
List.Positions Returnerer en liste over posisjoner for en inndataliste.
List.Range Returnerer et antall elementer som starter ved en forskyvning.
List.Select Merker elementene som samsvarer med en betingelse.
List.Single Returnerer enkeltelementet i listen eller kaster en Expression.Error hvis listen har mer enn ett element.
List.SingleOrDefault Returnerer ett enkelt element fra en liste.
List.Skip Hopper over det første elementet i listen. Gitt en tom liste, returnerer den en tom liste. Denne funksjonen tar en valgfri parameter countOrCondition for å støtte hoppe over flere verdier.

Transformasjonsfunksjoner

Navn Beskrivelse
List.Accumulate Akkumulerer et resultat fra listen. Fra startverdifrøet bruker denne funksjonen akkumulatorfunksjonen og returnerer det endelige resultatet.
List.Combine Slår sammen en liste med lister til én liste.
List.ConformToPageReader Denne funksjonen er bare ment for intern bruk.
List.RemoveRange Returnerer en liste som fjerner antall elementer som starter ved forskyvning. Standardantallet er 1.
List.RemoveFirstN Returnerer en liste med det angitte antallet elementer fjernet fra listen fra det første elementet. Antall elementer som fjernes, avhenger av den valgfrie countOrCondition parameteren.
List.RemoveItems Fjerner elementer fra list1 som finnes i list2, og returnerer en ny liste.
List.RemoveLastN Returnerer en liste med det angitte antallet elementer fjernet fra listen fra det siste elementet. Antall elementer som fjernes, avhenger av den valgfrie countOrCondition parameteren.
List.Repeat Returnerer en liste som gjentar innholdet i antall inndatalister.
List.ReplaceRange Returnerer en liste som erstatter antallverdier i en liste med en replaceWith liste som starter ved en indeks.
List.RemoveMatchingItems Fjerner alle forekomster av de angitte verdiene i listen.
List.RemoveNulls Fjerner nullverdier fra en liste.
List.ReplaceMatchingItems Erstatter forekomster av eksisterende verdier i listen med nye verdier ved hjelp av angitt equationCriteria. Gamle og nye verdier angis av replacements parameterne. Du kan angi en valgfri formelkriterieverdi for å kontrollere likhetssammenligninger. Hvis du vil ha mer informasjon om erstatningsoperasjoner og formelkriterier, kan du gå til Parameterverdier.
List.ReplaceValue Søker i en liste med verdier etter verdien og erstatter hver forekomst med erstatningsverdien.
List.Reverse Returnerer en liste som reverserer elementene i en liste.
List.Split Deler den angitte listen inn i en liste over lister ved hjelp av den angitte sidestørrelsen.
List.Transform Utfører funksjonen på hvert element i listen og returnerer den nye listen.
List.TransformMany Returnerer en liste med elementer som er projisert fra inndatalisten.

Medlemskapsfunksjoner

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

Navn Beskrivelse
List.AllTrue Returnerer sann hvis alle uttrykk i en liste er sanne
List.AnyTrue Returnerer sann hvis et uttrykk i en liste i sann
List.Contains Returnerer sann hvis en verdi finnes i en liste.
List.ContainsAll Returnerer sann hvis alle elementer i verdier finnes i en liste.
List.ContainsAny Returnerer sann hvis et element i verdier finnes i en liste.
List.PositionOf Finner den første forekomsten av en verdi i en liste og returnerer plasseringen.
List.PositionOfAny Finner den første forekomsten av en verdi i verdier og returnerer posisjonen.

Angi operasjoner

Navn Beskrivelse
List.Difference Returnerer elementene i liste 1 som ikke vises i liste 2. Dupliserte verdier støttes.
List.Intersect Returnerer en liste fra en liste over lister og krysser vanlige elementer i individuelle lister. Dupliserte verdier støttes.
List.Union Returnerer en liste fra en liste over lister og fagforeninger elementene i de individuelle listene. Den returnerte listen inneholder alle elementer i alle inndatalister. Dupliserte verdier samsvarer som en del av unionen.
List.Zip Returnerer en liste over lister som kombinerer elementer i samme posisjon.

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 en Expression.Error kastet.

Sammenlignbare datatyper inkluderer:

  • Nummer
  • Varighet
  • DateTime
  • Tekst
  • Logisk
  • Null
Navn Beskrivelse
List.Max Returnerer det maksimale elementet i en liste, eller den valgfrie standardverdien hvis listen er tom.
List.MaxN Returnerer maksimumsverdiene i listen. Antall verdier som skal returneres eller en filtreringsbetingelse må angis.
List.Median Returnerer medianelementet fra en liste.
List.Min Returnerer minimumselementet i en liste, eller den valgfrie standardverdien hvis listen er tom.
List.MinN Returnerer minimumsverdiene i en liste. Antall verdier som skal returneres eller en filtreringsbetingelse kan angis.
List.Sorter Returnerer en sortert liste ved hjelp av sammenligningskriteriet.
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 en gjennomsnittsverdi fra en liste i datatypen for verdiene i listen.
List.Mode Returnerer et element som vises oftest i en liste.
List.Modes Returnerer alle elementer som vises med samme maksimumsfrekvens.
List.StandardDeviation Returnerer standardavviket fra en liste med verdier. List.StandardDeviation 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 fra en liste.

Tall

Disse funksjonene fungerer bare over tall.

Navn Beskrivelse
List.Covariance Returnerer kovariansen fra to lister som et tall.
List.Product Returnerer produktet fra en liste med tall.

Generatorer

Disse funksjonene genererer en liste over verdier.

Navn Beskrivelse
List.Dates Returnerer en liste over datoverdier fra størrelsesantall, starter ved start og legger til en økning i hver verdi.
List.DateTimes Returnerer en liste over datetime-verdier fra størrelsesantall, starter ved start og legger til en økning i hver verdi.
List.DateTimeZones Returnerer en liste over datetimezone-verdier fra størrelsesantall, starter ved start og legger til en økning i hver verdi.
List.Durations Returnerer en liste over varighetsverdier fra størrelsesantall, starter ved start og legger til en økning i hver verdi.
List.Generate Genererer en liste over verdier.
List.Numbers Returnerer en liste over tall fra størrelsesantall fra start, og legger til en økning. Intervaller som standard er 1.
List.Random Returnerer en liste over tilfeldige tall, med en valgfri frøparameter.
List.Times Returnerer en liste over tidsverdier for størrelsesantall, som starter ved start.

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.Sorter.

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.