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

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Occurrence.All = 2;

Sorteringsrekkefølge.

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

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.