ListefunktionerList functions

Disse funktioner opretter og manipulerer listeværdier.These functions create and manipulate list values.

OplysningerInformation

FunktionFunction BeskrivelseDescription
List.CountList.Count Returnerer antallet af elementer på en liste.Returns the number of items in a list.
List.NonNullCountList.NonNullCount Returnerer antallet af elementer på en liste, undtagen null-værdier.Returns the number of items in a list excluding null values
List.IsEmptyList.IsEmpty Returnerer, om en liste er tom.Returns whether a list is empty.

MarkeringSelection

FunktionFunction BeskrivelseDescription
List.AlternateList.Alternate Returnerer en liste, hvor de elementer, der er knyttet til den oprindelige liste, er baseret på et antal, et valgfrit repeatInterval og en valgfri forskydning.Returns a list with the items alternated from the original list based on a count, optional repeatInterval, and an optional offset.
List.BufferList.Buffer Gemmer listen i bufferlageret.Buffers the list in memory. Resultatet af dette kald er en stabil liste, hvilket betyder, at det vil have et deterministisk antal og en deterministisk rækkefølge af varer.The result of this call is a stable list, which means it will have a determinimic count, and order of items.
List.DistinctList.Distinct Filtrerer en liste ned ved at fjerne dubletter.Filters a list down by removing duplicates. Du kan angive en valgfri kriterieværdi for ligningen for at styre kvalitetstesten.An optional equation criteria value can be specified to control equality comparison. Den første værdi fra hver ligningsgruppe vælges.The first value from each equality group is chosen.
List.FindTextList.FindText Søger på en liste over værdier, herunder postfelter, for en tekstværdi.Searches a list of values, including record fields, for a text value.
List.FirstList.First Returnerer den første værdi på listen eller den angivne standard, hvis listen er tom.Returns the first value of the list or the specified default if empty. Returnerer det første element på listen eller den valgfri standardværdi, hvis listen er tom.Returns the first item in the list, or the optional default value, if the list is empty. Hvis listen er tom, og der ikke er angivet en standardværdi, returnerer funktionen.If the list is empty and a default value is not specified, the function returns.
List.FirstNList.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.Returns the first set of items in the list by specifying how many items to return or a qualifying condition provided by countOrCondition.
List.InsertRangeList.InsertRange Indsætter elementer fra værdier i et givent indeks på inputlisten.Inserts items from values at the given index in the input list.
List.IsDistinctList.IsDistinct Returnerer, om en liste er specifik.Returns whether a list is distinct.
List.LastList.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.Returns the last set of items in the list by specifying how many items to return or a qualifying condition provided by countOrCondition.
List.LastNList.LastN Returnerer det sidste sæt elementer på listen ved at angive, hvor mange elementer der skal returneres, eller en kvalificerende betingelse.Returns the last set of items in a list by specifying how many items to return or a qualifying condition.
List.MatchesAllList.MatchesAll Returnerer Sand, hvis alle elementer på en liste opfylder en betingelse.Returns true if all items in a list meet a condition.
List.MatchesAnyList.MatchesAny Returnerer Sand, hvis et af elementerne på en liste opfylder en betingelse.Returns true if any item in a list meets a condition.
List.PositionsList.Positions Returnerer en liste over positioner for en inputliste.Returns a list of positions for an input list.
List.RangeList.Range Returnerer et antal elementer, der starter med en forskydning.Returns a count items starting at an offset.
List.SelectList.Select Markerer de elementer, der opfylder en betingelse.Selects the items that match a condition.
List.SingleList.Single Returnerer det enkelte element på listen eller udløser en Expression.Error, hvis listen indeholder mere end ét element.Returns the single item of the list or throws an Expression.Error if the list has more than one item.
List.SingleOrDefaultList.SingleOrDefault Returnerer et enkelt element fra en liste.Returns a single item from a list.
List.SkipList.Skip Springer det første element på listen over.Skips the first item of the list. Hvis der angives en tom liste, returneres en tom liste.Given an empty list, it returns an empty list. Denne funktion bruger en valgfri parameter countOrCondition til at understøtte, at flere værdier springes over.This function takes an optional parameter countOrCondition to support skipping multiple values.

TransformationsfunktionerTransformation functions

FunktionFunction BeskrivelseDescription
List.AccumulateList.Accumulate Akkumulerer et resultat fra listen.Accumulates a result from the list. Fra og med basisværdien anvender denne funktion akkumulatorfunktionen og returnerer det endelige resultat.Starting from the initial value seed this function applies the accumulator function and returns the final result.
List.CombineList.Combine Fletter en liste med lister til en enkelt liste.Merges a list of lists into single list.
List.RemoveRangeList.RemoveRange Returnerer en liste, der fjerner elementantal, med start ved forskydningen.Returns a list that removes count items starting at offset. Standardantallet er 1.The default count is 1.
List.RemoveFirstNList.RemoveFirstN Returnerer en liste med det angivne antal elementer fjernet fra listen med start ved det første element.Returns a list with the specified number of elements removed from the list starting at the first element. Det antal elementer, der fjernes, afhænger af den valgfri countOrCondition-parameter.The number of elements removed depends on the optional countOrCondition parameter.
List.RemoveItemsList.RemoveItems Fjerner elementer fra list1, der findes på list2, og returnerer en ny liste.Removes items from list1 that are present in list2, and returns a new list.
List.RemoveLastNList.RemoveLastN Returnerer en liste med det angivne antal elementer fjernet fra listen med start ved det sidste element.Returns a list with the specified number of elements removed from the list starting at the last element. Det antal elementer, der fjernes, afhænger af den valgfri countOrCondition-parameter.The number of elements removed depends on the optional countOrCondition parameter.
List.RepeatList.Repeat Returnerer en liste, der gentager indholdet af et inputliste et bestemt antal gange.Returns a list that repeats the contents of an input list count times.
List.ReplaceRangeList.ReplaceRange Returnerer en liste, der erstatter antallet af værdier på en liste med en replaceWith-liste, der starter ved et indeks.Returns a list that replaces count values in a list with a replaceWith list starting at an index.
List.RemoveMatchingItemsList.RemoveMatchingItems Fjerner alle forekomster af de angivne værdier på listen.Removes all occurrences of the given values in the list.
List.RemoveNullsList.RemoveNulls Fjerner null-værdier fra en liste.Removes null values from a list.
List.ReplaceMatchingItemsList.ReplaceMatchingItems Erstatter forekomster af eksisterende værdier på listen med nye værdier ved hjælp af den angivne equationCriteria.Replaces occurrences of existing values in the list with new values using the provided equationCriteria. Gamle og nye værdier leveres af erstatningsparametrene.Old and new values are provided by the replacements parameters. Du kan angive en valgfri kriterieværdi for ligningen for at styre kvalitetstestene.An optional equation criteria value can be specified to control equality comparisons. Du kan finde flere oplysninger om erstatningshandlinger og kriterier for ligninger i Parameterværdier.For details of replacement operations and equation criteria, see Parameter Values.
List.ReplaceValueList.ReplaceValue Søger på en liste med værdier og erstatter hver forekomst med erstatningsværdien.Searches a list of values for the value and replaces each occurrence with the replacement value.
List.ReverseList.Reverse Returnerer en liste, der tilbagefører elementerne på en liste.Returns a list that reverses the items in a list.
List.SplitList.Split Opdeler den angivne liste til en liste med lister ved hjælp af den angivne sidestørrelse.Splits the specified list into a list of lists using the specified page size.
List.TransformList.Transform Udfører funktionen for hvert element på listen og returnerer den nye liste.Performs the function on each item in the list and returns the new list.
List.TransformManyList.TransformMany Returnerer en liste, hvis elementer projiceres fra inputlisten.Returns a list whose elements are projected from the input list.

Funktioner for medlemskabMembership functions

Da alle værdier kan kvalitetstestes, kan disse funktioner bruges til heterogene lister.Since all values can be tested for equality, these functions can operate over heterogeneous lists.

FunktionFunction BeskrivelseDescription
List.AllTrueList.AllTrue Returnerer Sand, hvis alle udtryk på en liste er Sande.Returns true if all expressions in a list are true
List.AnyTrueList.AnyTrue Returnerer Sand, hvis et af udtrykkene på en liste er Sandt.Returns true if any expression in a list in true
List.ContainsList.Contains Returnerer Sand, hvis der findes en værdi på en liste.Returns true if a value is found in a list.
List.ContainsAllList.ContainsAll Returnerer Sand, hvis alle elementer i værdier findes på en liste.Returns true if all items in values are found in a list.
List.ContainsAnyList.ContainsAny Returnerer Sand, hvis et element i værdier findes på en liste.Returns true if any item in values is found in a list.
List.PositionOfList.PositionOf Finder den første forekomst af en værdi på en liste og returnerer dens position.Finds the first occurrence of a value in a list and returns its position.
List.PositionOfAnyList.PositionOfAny Finder den første forekomst af en værdi på en liste og returnerer dens position.Finds the first occurrence of any value in values and returns its position.

SæthandlingerSet operations

FunktionFunction BeskrivelseDescription
List.DifferenceList.Difference Returnerer de elementer på list1, der ikke vises på list2.Returns the items in list 1 that do not appear in list 2. Dubletværdier understøttes.Duplicate values are supported.
List.IntersectList.Intersect Returnerer en liste fra en liste over lister og skærer almindelige elementer på enkelte lister.Returns a list from a list of lists and intersects common items in individual lists. Dubletværdier understøttes.Duplicate values are supported.
List.UnionList.Union Returnerer en liste fra en liste over lister og forener elementerne på de enkelte lister.Returns a list from a list of lists and unions the items in the individual lists. Den returnerede liste indeholder alle elementer på alle inputlister.The returned list contains all items in any input lists. Dubletværdier matches som en del af foreningen.Duplicate values are matched as part of the Union.
List.ZipList.Zip Returnerer en liste over lister, der kombinerer elementer på samme position.Returns a list of lists combining items at the same position.

SorteringOrdering

Sorteringsfunktionerne udfører sammenligninger.Ordering functions perform comparisons. Alle de værdier, der sammenlignes, skal være sammenlignelige med hinanden.All values that are compared must be comparable with each other. Det betyder, at de alle skal komme fra den samme datatype (eller inkludere null, der altid sammenligner de mindste værdier).This means they must all come from the same datatype (or include null, which always compares smallest). I modsat fald udløses en Expression.Error.Otherwise, an Expression.Error is thrown.

Sammenlignelige datatyperComparable data types

  • TalNumber

  • VarighedDuration

  • DateTimeDateTime

  • TekstText

  • LogiskLogical

  • NullNull

FunktionFunction BeskrivelseDescription
List.MaxList.Max Returnerer det maksimale element på en liste eller den valgfri standardværdi, hvis listen er tom.Returns the maximum item in a list, or the optional default value if the list is empty.
List.MaxNList.MaxN Returnerer de maksimale værdier på listen.Returns the maximum values in the list. Når rækkerne er blevet sorteret, kan valgfri parametre angives for at filtrere resultatet yderligere.After the rows are sorted, optional parameters may be specified to further filter the result
List.MedianList.Median Returnerer medianelementet fra en liste.Returns the median item from a list.
List.MinList.Min Returnerer minimumelementet på en liste eller den valgfri standardværdi, hvis listen er tom.Returns the minimum item in a list, or the optional default value if the list is empty.
List.MinNList.MinN Returnerer minimumværdierne på en liste.Returns the minimum values in a list.
List.SortList.Sort Returnerer en sorteret liste ved hjælp af sammenligningskriteriet.Returns a sorted list using comparison criterion.

GennemsnitAverages

Disse funktioner fungerer på tværs af homogene lister med tal, datetimes og varigheder.These functions operate over homogeneous lists of Numbers, DateTimes, and Durations.

FunktionFunction BeskrivelseDescription
List.AverageList.Average Returnerer en gennemsnitlig værdi fra en liste i datatypen for værdierne på listen.Returns an average value from a list in the datatype of the values in the list.
List.ModeList.Mode Returnerer et element, der vises hyppigst på en liste.Returns an item that appears most commonly in a list.
List.ModesList.Modes Returnerer alle elementer, der vises med samme maksimumfrekvens.Returns all items that appear with the same maximum frequency.
List.StandardDeviationList.StandardDeviation Returnerer standardafvigelsen fra en liste over værdier.Returns the standard deviation from a list of values. List.StandardDeviation udfører et estimat, der er baseret på et eksempel.List.StandardDeviation performs a sample based estimate. Resultatet er et tal for tal og en varighed for datetimes og varigheder.The result is a number for numbers, and a duration for DateTimes and Durations.

AdditionAddition

Disse funktioner fungerer på tværs af homogene lister med tal eller varigheder.These functions work over homogeneous lists of Numbers or Durations.

FunktionFunction BeskrivelseDescription
List.SumList.Sum Returnerer summen fra en liste.Returns the sum from a list.

Numeriske tegnNumerics

Disse funktioner fungerer kun med tal.These functions only work over numbers.

FunktionFunction BeskrivelseDescription
List.CovarianceList.Covariance Returnerer kovariansen fra to lister som et tal.Returns the covariance from two lists as a number.
List.ProductList.Product Returnerer produktet fra en liste med tal.Returns the product from a list of numbers.

GeneratorerGenerators

Disse funktioner genererer en liste over værdier.These functions generate list of values.

FunktionFunction BeskrivelseDescription
List.DatesList.Dates Returnerer en liste over datoværdier fra størrelsesantal, der starter ved start, og føjer en forøgelse til hver værdi.Returns a list of date values from size count, starting at start and adds an increment to every value.
List.DateTimesList.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.Returns a list of datetime values from size count, starting at start and adds an increment to every value.
List.DateTimeZonesList.DateTimeZones Returnerer en liste over datetime-zoner fra størrelsesantal, der starter ved start, og føjer en gradvis forøgelse til hver værdi.Returns a list of of datetimezone values from size count, starting at start and adds an increment to every value.
List.DurationsList.Durations Returnerer en liste over varighedsværdier fra størrelsesantal, der starter ved start, og føjer en gradvis forøgelse til hver værdi.Returns a list of durations values from size count, starting at start and adds an increment to every value.
List.GenerateList.Generate Opretter en liste fra en værdifunktion, en betingelsesfunktion, en næste-funktion og en valgfri transformationsfunktion for værdierne.Generates a list from a value function, a condition function, a next function, and an optional transformation function on the values.
List.NumbersList.Numbers Returnerer en liste over tal fra størrelsesantallet med start ved start og tilføjer en gradvis forøgelse.Returns a list of numbers from size count starting at initial, and adds an increment. Den gradvise forøgelse er som standard 1.The increment defaults to 1.
List.RandomList.Random Returnerer en liste med antallet af tilfældige tal med en valgfri Seed-parameter.Returns a list of count random numbers, with an optional seed parameter.
List.TimesList.Times Returnerer en liste over tidsværdier for størrelsesantal, der begynder ved start.Returns a list of time values of size count, starting at start.

ParameterværdierParameter values

ForekomstspecifikationOccurrence specification

  • Occurrence.First = 0;Occurrence.First = 0;

  • Occurrence.Last = 1;Occurrence.Last = 1;

  • Occurrence.All = 2;Occurrence.All = 2;

SorteringsrækkefølgenSort order

  • Order.Ascending = 0;Order.Ascending = 0;

  • Order.Descending = 1;Order.Descending = 1;

LigningskriterierEquation criteria

Ligningskriterier for listeværdier kan angives som enten:Equation criteria for list values can be specified as either a

  • En funktionsværdi, der er begge dele.A function value that is either

    • En nøglevælger, der bestemmer værdien på listen for at anvende kvalitetskriterierne.A key selector that determines the value in the list to apply the equality criteria, or

    • En sammenligningsfunktion, der bruges til at angive, hvilken type sammenligning der skal anvendes.A comparer function that is used to specify the kind of comparison to apply. Du kan angive integrerede sammenligningsfunktioner. Se afsnittet om sammenligningsfunktioner.Built in comparer functions can be specified, see section for Comparer functions.

  • En listeværdi, der harA list value which has

    • Præcis to elementerExactly two items

    • Det første element er nøglevælgeren, som angivet ovenfor.The first element is the key selector as specified above

    • Det andet element er en sammenligningsfunktion som angivet ovenfor.The second element is a comparer as specified above.

Du kan få flere oplysninger og eksempler under List.Distinct.For more information and examples, see List.Distinct.

SammenligningskriterierComparison criteria

Sammenligningskriterier kan angives som en af følgende værdier:Comparison criterion can be provided as either of the following values:

  • En talværdi, der angiver en sorteringsrækkefølge.A number value to specify a sort order. Du kan finde flere oplysninger under sorteringsrækkefølge i Parameterværdier.For more inforarmtion, see sort order in Parameter values.

  • Hvis du vil beregne en nøgle, der skal bruges til sortering, kan der bruges en funktion på ét argument.To compute a key to be used for sorting, a function of 1 argument can be used.

  • Hvis du både vil vælge en nøgle og styre rækkefølgen, kan sammenligningskriteriet være en liste, der indeholder nøglen og rækkefølgen.To both select a key and control order, comparison criterion can be a list containing the key and order.

  • Hvis du vil have fuldstændig kontrol over sammenligningen, kan en funktion med to argumenter bruges, der returnerer -1, 0 eller 1, afhængigt af relationen mellem venstre og højre input.To completely control the comparison, a function of 2 arguments can be used that returns -1, 0, or 1 given the relationship between the left and right inputs. Value.Compare er en metode, der kan bruges til at uddelegere denne logik.Value.Compare is a method that can be used to delegate this logic.

Du kan få flere oplysninger og eksempler under List.Sort.For more information and examples, see List.Sort.

ErstatningshandlingerReplacement operations

Erstatningshandlinger angives med en listeværdi, og hvert element på listen skal væreReplacement operations are specified by a list value, each item of this list must be

  • En listeværdi med præcis to elementerA list value of exactly two items

  • Det første element er den gamle værdi på listen, som skal erstattesFist item is the old value in the list, to be replaced

  • Det andet element er den nye værdi, som skal erstatte alle forekomster af den gamle værdi på listenSecond item is the new which should replace all occurrences of the old value in the list