Listefunktioner

Disse funktioner opretter og manipulerer listeværdier.

Information

Name	Description
List.Count	Returnerer antallet af elementer på en liste.
List.NonNullCount	Returnerer antallet af elementer på en liste, der udelader null-værdier
List.IsEmpty	Returnerer, om en liste er tom.

Valg

Name	Description
List.Alternate	Returnerer en liste med de elementer, der er vekslet fra den oprindelige liste, baseret på et antal, valgfrit repeatInterval og en valgfri forskydning.
List.Buffer	Gemmer listen i buffer i hukommelsen. Resultatet af dette kald er en stabil liste, hvilket betyder, at det vil have et afskrækkende antal og rækkefølgen af elementer.
List.Distinct	Filtrerer en liste ned ved at fjerne dubletter. Der kan angives en valgfri kriterieværdi for ligninger for at styre lighedssammenligningen. Den første værdi fra hver lighedsgruppe vælges.
List.FindText	Søger efter en tekstværdi på en liste over værdier, herunder postfelter.
List.First	Returnerer den første værdi på listen eller den angivne standard, hvis den er tom. Returnerer det første element på listen eller den valgfri standardværdi, hvis listen er tom. Hvis listen er tom, og der ikke er angivet en standardværdi, returnerer funktionen .
List.FirstN	Returnerer det første sæt elementer på listen ved at angive, hvor mange elementer der skal returneres, eller en kvalificerende betingelse, der leveres af countOrCondition.
List.InsertRange	Indsætter elementer fra værdier ved det angivne indeks på inputlisten.
List.IsDistinct	Returnerer, om en liste er entydig.
List.Last	Returnerer det sidste sæt elementer på listen ved at angive, hvor mange elementer der skal returneres, eller en kvalificerende betingelse, der leveres af countOrCondition.
List.LastN	Returnerer det sidste sæt elementer på en liste ved at angive, hvor mange elementer der skal returneres, eller en kvalificerende betingelse.
List.MatchesAll	Returnerer true, hvis alle elementer på en liste opfylder en betingelse.
List.MatchesAny	Returnerer true, hvis et element på en liste opfylder en betingelse.
List.Positions	Returnerer en liste over positioner for en inputliste.
List.Range	Returnerer et antal elementer, der starter ved en forskydning.
List.Select	Vælger de elementer, der svarer til en betingelse.
List.Single	Returnerer det enkelte element på listen eller udløser en Expression.Error , hvis listen har mere end ét element.
List.SingleOrDefault	Returnerer et enkelt element fra en liste.
List.Skip	Springer det første element på listen over. Hvis der angives en tom liste, returneres en tom liste. Denne funktion bruger en valgfri parameter countOrCondition til at understøtte spring over flere værdier.

Transformationsfunktioner

Name	Description
List.Accumulate	Akkumulerer et resultat fra listen. Fra og med startværdien anvender denne funktion akkumulatorfunktionen og returnerer det endelige resultat.
List.Combine	Fletter en liste over lister til en enkelt liste.
List.ConformToPageReader	Denne funktion er kun beregnet til intern brug.
List.RemoveRange	Returnerer en liste, der fjerner antal elementer, der starter ved forskydning. Standardantallet er 1.
List.RemoveFirstN	Returnerer en liste, hvor det angivne antal elementer er fjernet fra listen med start ved det første element. Det antal elementer, der fjernes, afhænger af den valgfri countOrCondition parameter.
List.RemoveItems	Fjerner elementer fra list1 , der findes i list2, og returnerer en ny liste.
List.RemoveLastN	Returnerer en liste, hvor det angivne antal elementer er fjernet fra listen med start ved det sidste element. Det antal elementer, der fjernes, afhænger af den valgfri countOrCondition parameter.
List.Repeat	Returnerer en liste, der gentager indholdet af en inputlisteantal gange.
List.ReplaceRange	Returnerer en liste, der erstatter antal værdier på en liste med en replaceWith liste, der starter ved et indeks.
List.RemoveMatchingItems	Fjerner alle forekomster af de angivne værdier på listen.
List.RemoveNulls	Fjerner null-værdier fra en liste.
List.ReplaceMatchingItems	Erstatter forekomster af eksisterende værdier på listen med nye værdier ved hjælp af den angivne equationCriteria. Gamle og nye værdier leveres af parametrene replacements . Der kan angives en valgfri kriterieværdi for ligninger for at styre lighedssammenligninger. Du kan finde flere oplysninger om erstatningshandlinger og ligningskriterier ved at gå til Parameterværdier.
List.ReplaceValue	Søger på en liste over værdier for værdien og erstatter hver forekomst med erstatningsværdien.
List.Reverse	Returnerer en liste, der fortryder elementerne på en liste.
List.Split	Opdeler den angivne liste i en liste over lister ved hjælp af den angivne sidestørrelse.
List.Transform	Udfører funktionen for hvert element på listen og returnerer den nye liste.
List.TransformMany	Returnerer en liste, hvis elementer projekteres fra inputlisten.

Medlemskabsfunktioner

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

Name	Description
List.AllTrue	Returnerer true, hvis alle udtryk på en liste er true
List.AnyTrue	Returnerer sand, hvis et udtryk på en liste i true
List.Contains	Returnerer true, hvis der findes en værdi på en liste.
List.ContainsAll	Returnerer true, hvis alle elementer i værdier findes på en liste.
List.ContainsAny	Returnerer true, hvis der findes et element i værdier på en liste.
List.PositionOf	Finder den første forekomst af en værdi på en liste og returnerer dens placering.
List.PositionOfAny	Finder den første forekomst af en værdi i værdier og returnerer dens placering.

Angiv handlinger

Name	Description
List.Difference	Returnerer de elementer på liste 1, der ikke vises på liste 2. Dubletværdier understøttes.
List.Intersect	Returnerer en liste fra en liste over lister og skærer almindelige elementer på individuelle lister. Dubletværdier understøttes.
List.Union	Returnerer en liste fra en liste over lister og samler elementerne på de enkelte lister. Den returnerede liste indeholder alle elementer på alle inputlister. Dubletværdier matches som en del af Unionen.
List.Zip	Returnerer en liste over lister, der kombinerer elementer på samme placering.

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:

• nummer
• Varighed
• Datetime
• Text
• Logisk
• Null

Name	Description
List.Max	Returnerer det maksimale element på en liste eller den valgfri standardværdi, hvis listen er tom.
List.MaxN	Returnerer de maksimale værdier på listen. Det antal værdier, der skal returneres, eller en filtreringsbetingelse skal angives.
List.Median	Returnerer medianen fra en liste.
List.Min	Returnerer minimumelementet på en liste eller den valgfri standardværdi, hvis listen er tom.
List.MinN	Returnerer minimumværdierne på en liste. Det antal værdier, der skal returneres, eller en filtreringsbetingelse kan angives.
List.Sortér	Returnerer en sorteret liste ved hjælp af sammenligningskriterier.
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.

Name	Description
List.Average	Returnerer en gennemsnitlig værdi fra en liste i datatypen for værdierne på listen.
List.Mode	Returnerer et element, der oftest vises på en liste.
List.Modes	Returnerer alle elementer, der vises med samme maksimale hyppighed.
List.StandardDeviation	Returnerer standardafvigelsen fra en liste over værdier. List.StandardDeviation 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.

Name	Description
List.Sum	Returnerer summen fra en liste.

Numeriske tegn

Disse funktioner fungerer kun for tal.

Name	Description
List.Covariance	Returnerer kovariansen fra to lister som et tal.
List.Product	Returnerer produktet fra en liste over tal.

Generatorer

Disse funktioner genererer en liste over værdier.

Name	Description
List.Dates	Returnerer en liste over datoværdier fra størrelsesantal, der starter ved start, og føjer en forøgelse til hver værdi.
List.DateTimes	Returnerer en liste over datetime-værdier fra størrelsesantal, der starter ved start, og føjer en forøgelse til hver værdi.
List.DateTimeZones	Returnerer en liste over datetimezone-værdier fra størrelsesantal, der starter ved start, og føjer en forøgelse til hver værdi.
List.Durations	Returnerer en liste over varighedsværdier fra størrelsesantal, der starter ved start, og føjer en forøgelse til hver værdi.
List.Generate	Genererer en liste over værdier.
List.Numbers	Returnerer en liste over tal fra størrelsesantal, der starter ved start, og tilføjer en forøgelse. Forøgelsen er som standard 1.
List.Random	Returnerer en liste over antallet af tilfældige tal med en valgfri seedparameter.
List.Times	Returnerer en liste over klokkeslætsværdier for størrelsesantal, der starter ved start.

Parameterværdier

Specifikation af forekomst

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

Sorteringsrækkefølge

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

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. Indbyggede sammenligningsfunktioner kan angives – 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 finde 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.