Del via

Listefunktioner

  • Artikel

Disse funktioner opretter og manipulerer listeværdier.

Information

Navn Beskrivelse
List.Count Returnerer antallet af elementer på en liste.
List.IsEmpty Returnerer true, hvis listen er tom.
List.NonNullCount Returnerer antallet af elementer, der ikke er null, på listen.

Valg

Navn Beskrivelse
List.Alternate Returnerer en liste, der består af alle forskydningselementer med ulige tal på en liste.
List.Buffer Gemmer en liste i buffer.
List.Distinct Returnerer en liste over værdier, hvor dubletter er fjernet.
List.FindText Returnerer en liste over værdier (herunder postfelter), der indeholder den angivne tekst.
List.First Returnerer den første værdi på listen eller den angivne standard, hvis den er tom.
List.FirstN Returnerer det første sæt elementer på listen ved at angive, hvor mange elementer der skal returneres, eller en kvalificerende betingelse.
List.InsertRange Indsætter værdier på en liste ved det angivne indeks.
List.IsDistinct Angiver, om der er dubletter på listen.
List.Last Returnerer den sidste værdi på listen eller den angivne standard, hvis den er tom.
List.LastN Returnerer den sidste værdi på listen. Kan eventuelt angive, hvor mange værdier der skal returneres, eller en kvalificerende betingelse.
List.MatchesAll Returnerer true, hvis betingelsesfunktionen opfyldes af alle værdier på listen.
List.MatchesAny Returnerer true, hvis betingelsesfunktionen opfyldes af en værdi.
List.Positions Returnerer en liste over forskydninger for inputtet.
List.Range Returnerer et undersæt af listen, der starter ved en forskydning.
List.Select Returnerer en liste over værdier, der svarer til betingelsen.
List.Single Returnerer det ene listeelement for en liste med længden ét, ellers udløses der en undtagelse.
List.SingleOrDefault Returnerer det ene listeelement for en liste med længden ét og standardværdien for en tom liste.
List.Skip Returnerer en liste, der springer det angivne antal elementer over i starten af listen.

Transformationsfunktioner

Navn Beskrivelse
List.Accumulate AAccumulates en oversigtsværdi fra elementerne på listen.
List.Combine Returnerer en enkelt liste ved at kombinere flere lister.
List.ConformToPageReader Denne funktion er kun beregnet til intern brug.
List.RemoveFirstN Returnerer en liste, der springer det angivne antal elementer over i starten af listen.
List.RemoveItems Fjerner elementer fra den første liste, der findes på den anden liste.
List.RemoveLastN Returnerer en liste, der fjerner det angivne antal elementer fra slutningen af listen.
List.RemoveMatchingItems Fjerner alle forekomster af inputværdierne.
List.RemoveNulls Fjerner alle null værdier fra den angivne liste.
List.RemoveRange Fjerner antallet af værdier, der starter ved den angivne placering.
List.Repeat Returnerer en liste, der er count gentagelser af den oprindelige liste.
List.ReplaceMatchingItems Erstatter forekomster af eksisterende værdier på listen med nye værdier, der svarer til betingelsen.
List.ReplaceRange Erstatter count antal værdier, der starter ved position, med erstatningsværdierne.
List.ReplaceValue Søger på en liste efter den angivne værdi og erstatter den.
List.Reverse Ændrer rækkefølgen af værdier på listen.
List.Split Opdeler den angivne liste i en liste over lister ved hjælp af den angivne sidestørrelse.
List.Transform Returnerer en ny liste over værdier, der er beregnet ud fra denne liste.
List.TransformMany Returnerer en liste, hvis elementer transformeres fra inputlisten ved hjælp af angivne funktioner.
List.Zip Returnerer en liste over lister ved at kombinere elementer på samme placering på flere lister.

Medlemskabsfunktioner

Da alle værdier kan testes for lighed, kan disse funktioner fungere på heterogene lister.

Navn Beskrivelse
List.AllTrue Returnerer true, hvis alle udtryk er sande.
List.AnyTrue Returnerer true, hvis et udtryk er true.
List.Contains Angiver, om listen indeholder værdien.
List.ContainsAll Angiver, hvor en liste indeholder alle værdierne på en anden liste.
List.ContainsAny Angiver, hvor en liste indeholder en af værdierne på en anden liste.
List.PositionOf Returnerer forskydningen eller forskydningen af en værdi på en liste.
List.PositionOfAny Returnerer den første forskydning af en værdi på en liste.

Angiv handlinger

Navn Beskrivelse
List.Difference Returnerer forskellen mellem de to angivne lister.
List.Intersect Returnerer skæringspunktet for de listeværdier, der blev fundet i inputtet.
List.Union Returnerer foreningen af de listeværdier, der blev fundet i inputtet.

Bestilling

Sorteringsfunktioner udfører sammenligninger. Alle værdier, der sammenlignes, skal være sammenlignelige med hinanden. Det betyder, at de alle skal komme fra den samme datatype (eller indeholde null, som altid sammenligner mindst). Ellers udløses en Expression.Error.

Sammenlignelige datatyper omfatter:

  • Tal
  • Varighed
  • DateTime
  • Tekst
  • Logisk
  • Nul
Navn Beskrivelse
List.Max Returnerer maksimumværdien eller standardværdien for en tom liste.
List.MaxN Returnerer den eller de maksimale værdier på listen. Det antal værdier, der skal returneres, eller en filtreringsbetingelse skal angives.
List.Median Returnerer medianen på listen.
List.Min Returnerer minimumværdien eller standardværdien for en tom liste.
List.MinN Returnerer den eller de mindste værdier på listen. Det antal værdier, der skal returneres, eller en filtreringsbetingelse kan angives.
List.Sort Sorterer en liste over data i henhold til de angivne kriterier.
List.Percentile Returnerer en eller flere eksempel percentiler, der svarer til de angivne sandsynligheder.

Gennemsnit

Disse funktioner fungerer over homogene lister over tal, datetimes og varigheder.

Navn Beskrivelse
List.Average Returnerer gennemsnittet af værdierne. Fungerer sammen med værdier for tal, dato, datetime, datetimezone og varighed.
List.Mode Returnerer den hyppigste værdi på listen.
List.Modes Returnerer en liste over de hyppigste værdier på listen.
List.StandardDeviation Returnerer et eksempelbaseret estimat af standardafvigelsen. Denne funktion udfører et eksempelbaseret estimat. Resultatet er et tal for tal og en varighed for DateTimes og Durations.

Tilføjelse

Disse funktioner fungerer over homogene lister over tal eller varigheder.

Navn Beskrivelse
List.Sum Returnerer summen af elementerne på listen.

Numeriske værdier

Disse funktioner fungerer kun for tal.

Navn Beskrivelse
List.Covariance Returnerer kovariansen mellem de to lister med tal.
List.Product Returnerer produktet af tallene på listen.

Generatorer

Disse funktioner genererer en liste over værdier.

Navn Beskrivelse
List.Dates Genererer en liste over date værdier med en startværdi, et antal og en værdi for trinvis varighed.
List.DateTimes Genererer en liste over datetime værdier med en startværdi, et antal og en værdi for trinvis varighed.
List.DateTimeZones Genererer en liste over datetimezone værdier med en startværdi, et antal og en værdi for trinvis varighed.
List.Durations Genererer en liste over duration værdier med en startværdi, et antal og en værdi for trinvis varighed.
List.Generate Genererer en liste over værdier.
List.Numbers Returnerer en liste over tal, der har en startværdi, et antal og en valgfri trinvis værdi.
List.Random Returnerer en liste over tilfældige tal.
List.Times Genererer en liste over time værdier med en startværdi, et antal og en værdi for trinvis varighed.

Parameterværdier

Specifikation af forekomst

Sorteringsrækkefølge

Kriterier for ligning

Ligningskriterier for listeværdier kan angives som enten:

  • En funktionsværdi, der er enten:
    • En nøglevælger, der bestemmer værdien på listen for at anvende lighedskriterierne.
    • En sammenligningsfunktion, der bruges til at angive den type sammenligning, der skal anvendes. Der kan angives indbyggede sammenligningsfunktioner – gå til Sammenligningsfunktioner.
  • En listeværdi, der har:
    • Præcis to elementer.
    • Det første element er nøglevælgeren som angivet ovenfor.
    • Det andet element er en sammenligningsfunktion som angivet ovenfor.

Du kan få flere oplysninger og eksempler ved at gå til List.Distinct.

Sammenligningskriterier

Sammenligningskriteriet kan angives som en af følgende værdier:

  • En talværdi til at angive en sorteringsrækkefølge. Du kan finde flere oplysninger ved at gå til Sorteringsrækkefølge.
  • Hvis du vil beregne en nøgle, der skal bruges til sortering, kan du bruge en funktion af ét argument.
  • Hvis du både vil vælge en nøgle og en kontrolrækkefølge, kan sammenligningskriteriet være en liste, der indeholder nøglen og rækkefølgen.
  • Hvis du vil styre sammenligningen fuldstændigt, kan der bruges en funktion med to argumenter, der returnerer -1, 0 eller 1 i forhold til relationen mellem venstre og højre input. Value.Compare er en metode, der kan bruges til at delegere denne logik.

Du kan få flere oplysninger og eksempler ved at gå til List.Sort.

Erstatningshandlinger

Erstatningshandlinger angives af en listeværdi. Hvert element på listen skal være:

  • En listeværdi på præcis to elementer.
  • Det første element er den gamle værdi på listen, der skal erstattes.
  • Det andet element er den nye værdi, som skal erstatte alle forekomster af den gamle værdi på listen.