Lijstfuncties
Met deze functies worden lijstwaarden gemaakt en bewerkt.
Gegevens
Naam | Beschrijving |
---|---|
List.Count | Retourneert het aantal items in een lijst. |
List.NonNullCount | Geeft als resultaat het aantal items in een lijst met uitzondering van null-waarden |
List.IsEmpty | Retourneert of een lijst leeg is. |
Selectie
Naam | Beschrijving |
---|---|
List.Alternate | Retourneert een lijst met de items die zijn afgewisseld van de oorspronkelijke lijst op basis van een telling, optionele repeatInterval en een optionele offset. |
List.Buffer | Buffert de lijst in het geheugen. Het resultaat van deze aanroep is een stabiele lijst, wat betekent dat het een determinimic count en de volgorde van items heeft. |
List.Distinct | Hiermee filtert u een lijst omlaag door duplicaten te verwijderen. Er kan een optionele vergelijkingscriteriawaarde worden opgegeven om gelijkheidsvergelijking te bepalen. De eerste waarde van elke gelijkheidsgroep wordt gekozen. |
List.FindText | Zoekt in een lijst met waarden, inclusief recordvelden, naar een tekstwaarde. |
List.First | Retourneert de eerste waarde van de lijst of de opgegeven standaardwaarde als deze leeg is. Retourneert het eerste item in de lijst of de optionele standaardwaarde als de lijst leeg is. Als de lijst leeg is en er geen standaardwaarde is opgegeven, retourneert de functie. |
List.FirstN | Retourneert de eerste set items in de lijst door op te geven hoeveel items moeten worden geretourneerd of door een in aanmerking komende voorwaarde die is opgegeven door countOrCondition . |
List.InsertRange | Hiermee voegt u items uit waarden in de opgegeven index in de invoerlijst in. |
List.IsDistinct | Retourneert of een lijst uniek is. |
List.Last | Retourneert de laatste set items in de lijst door op te geven hoeveel items moeten worden geretourneerd of door een in aanmerking komende voorwaarde die is opgegeven door countOrCondition . |
List.LastN | Retourneert de laatste set items in een lijst door op te geven hoeveel items moeten worden geretourneerd of een in aanmerking komende voorwaarde. |
List.MatchesAll | Retourneert waar als alle items in een lijst voldoen aan een voorwaarde. |
List.MatchesAny | Retourneert waar als een item in een lijst voldoet aan een voorwaarde. |
List.Positions | Retourneert een lijst met posities voor een invoerlijst. |
List.Range | Retourneert een aantal items die beginnen bij een offset. |
List.Select | Selecteert de items die overeenkomen met een voorwaarde. |
List.Single | Retourneert het enkele item van de lijst of genereert een Expression.Error als de lijst meer dan één item heeft. |
List.SingleOrDefault | Retourneert één item uit een lijst. |
List.Skip | Hiermee wordt het eerste item van de lijst overgeslagen. Op basis van een lege lijst wordt een lege lijst geretourneerd. Deze functie gebruikt een optionele parameter countOrCondition ter ondersteuning van het overslaan van meerdere waarden. |
Transformatiefuncties
Naam | Beschrijving |
---|---|
List.Accumulate | Verzamelt een resultaat uit de lijst. Vanaf de beginwaarde van deze functie wordt de accumulatorfunctie toegepast en wordt het uiteindelijke resultaat geretourneerd. |
List.Combine | Hiermee wordt een lijst met lijsten samengevoegd tot één lijst. |
List.ConformToPageReader | Deze functie is alleen bedoeld voor intern gebruik. |
List.RemoveRange | Retourneert een lijst die het aantal items verwijdert dat begint bij verschuiving. Het standaardaantal is 1. |
List.RemoveFirstN | Retourneert een lijst met het opgegeven aantal elementen dat is verwijderd uit de lijst vanaf het eerste element. Het aantal verwijderde elementen is afhankelijk van de optionele countOrCondition parameter. |
List.RemoveItems | Hiermee verwijdert u items uit list1 die aanwezig zijn in list2 en retourneert u een nieuwe lijst. |
List.RemoveLastN | Retourneert een lijst met het opgegeven aantal elementen dat is verwijderd uit de lijst vanaf het laatste element. Het aantal verwijderde elementen is afhankelijk van de optionele countOrCondition parameter. |
List.Repeat | Retourneert een lijst die de inhoud van een aantal invoerlijsten herhaalt. |
List.ReplaceRange | Retourneert een lijst die tellingswaarden in een lijst vervangt door een replaceWith lijst die begint bij een index. |
List.RemoveMatchingItems | Hiermee verwijdert u alle exemplaren van de opgegeven waarden in de lijst. |
List.RemoveNulls | Hiermee verwijdert u null-waarden uit een lijst. |
List.ReplaceMatchingItems | Vervangt exemplaren van bestaande waarden in de lijst door nieuwe waarden met behulp van de opgegeven equationCriteria . Oude en nieuwe waarden worden opgegeven door de replacements parameters. Er kan een optionele vergelijkingscriteriawaarde worden opgegeven om gelijkheidsvergelijkingen te beheren. Ga naar Parameterwaarden voor meer informatie over vervangingsbewerkingen en vergelijkingscriteria. |
List.ReplaceValue | Zoekt in een lijst met waarden voor de waarde en vervangt elke instantie door de vervangende waarde. |
List.Reverse | Retourneert een lijst die de items in een lijst omdraait. |
List.Split | Hiermee wordt de opgegeven lijst gesplitst in een lijst met lijsten met behulp van het opgegeven paginaformaat. |
List.Transform | Voert de functie uit voor elk item in de lijst en retourneert de nieuwe lijst. |
List.TransformMany | Retourneert een lijst waarvan de elementen uit de invoerlijst worden geprojecteerd. |
Lidmaatschapsfuncties
Omdat alle waarden kunnen worden getest op gelijkheid, kunnen deze functies worden uitgevoerd via heterogene lijsten.
Naam | Beschrijving |
---|---|
List.AllTrue | Retourneert waar als alle expressies in een lijst waar zijn |
List.AnyTrue | Retourneert waar als een expressie in een lijst waar is |
List.Contains | Retourneert waar als een waarde wordt gevonden in een lijst. |
List.ContainsAll | Retourneert waar als alle items in waarden in een lijst worden gevonden. |
List.ContainsAny | Retourneert waar als een item in waarden in een lijst wordt gevonden. |
List.PositionOf | Hiermee wordt het eerste exemplaar van een waarde in een lijst gevonden en wordt de positie ervan geretourneerd. |
List.PositionOfAny | Zoekt het eerste exemplaar van een waarde in waarden en retourneert de positie. |
Bewerkingen instellen
Naam | Beschrijving |
---|---|
List.Difference | Retourneert de items in lijst 1 die niet worden weergegeven in lijst 2. Dubbele waarden worden ondersteund. |
List.Intersect | Retourneert een lijst uit een lijst met lijsten en kruist algemene items in afzonderlijke lijsten. Dubbele waarden worden ondersteund. |
List.Union | Retourneert een lijst uit een lijst met lijsten en samenvoegt de items in de afzonderlijke lijsten. De geretourneerde lijst bevat alle items in invoerlijsten. Dubbele waarden worden vergeleken als onderdeel van de Unie. |
List.Zip | Retourneert een lijst met lijsten waarin items op dezelfde positie worden gecombineerd. |
Ordenen
Volgordefuncties voeren vergelijkingen uit. Alle waarden die worden vergeleken, moeten met elkaar vergelijkbaar zijn. Dit betekent dat ze allemaal afkomstig moeten zijn van hetzelfde gegevenstype (of null bevatten, waarmee altijd het kleinste wordt vergeleken). Anders wordt er een Expression.Error
gegooid.
Vergelijkbare gegevenstypen zijn:
- Aantal
- Duur
- Datum/tijd
- Sms verzenden
- Logisch
- Nul
Naam | Beschrijving |
---|---|
List.Max | Retourneert het maximumitem in een lijst of de optionele standaardwaarde als de lijst leeg is. |
List.MaxN | Retourneert de maximumwaarden in de lijst. Het aantal waarden dat moet worden geretourneerd of een filtervoorwaarde moet worden opgegeven. |
List.Mediaan | Retourneert het mediaanitem uit een lijst. |
List.Min | Retourneert het minimumitem in een lijst of de optionele standaardwaarde als de lijst leeg is. |
List.MinN | Retourneert de minimumwaarden in een lijst. Het aantal waarden dat moet worden geretourneerd of een filtervoorwaarde kan worden opgegeven. |
List.Sort | Retourneert een gesorteerde lijst met vergelijkingscriterium. |
List.Percentiel | Retourneert een of meer percentielen die overeenkomen met de gegeven waarschijnlijkheden. |
Gemiddelden
Deze functies werken via homogene lijsten met getallen, datum/tijd en duur.
Naam | Beschrijving |
---|---|
List.Average | Retourneert een gemiddelde waarde uit een lijst in het gegevenstype van de waarden in de lijst. |
List.Mode | Retourneert een item dat het meest voorkomt in een lijst. |
List.Modes | Retourneert alle items die met dezelfde maximale frequentie worden weergegeven. |
List.StandardDeviation | Retourneert de standaarddeviatie van een lijst met waarden. List.StandardDeviation voert een steekproefgebaseerde schatting uit. Het resultaat is een getal voor getallen en een duur voor Datum/tijd en Duur. |
Aanvullend
Deze functies werken via homogene lijsten met getallen of duur.
Naam | Beschrijving |
---|---|
List.Sum | Retourneert de som uit een lijst. |
Cijfers
Deze functies werken alleen over getallen.
Naam | Beschrijving |
---|---|
List.Covariance | Retourneert de covariantie van twee lijsten als een getal. |
List.Product | Retourneert het product uit een lijst met getallen. |
Generators
Met deze functies wordt een lijst met waarden gegenereerd.
Naam | Beschrijving |
---|---|
List.Dates | Retourneert een lijst met datumwaarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde. |
List.DateTimes | Retourneert een lijst met datum/tijd-waarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde. |
List.DateTimeZones | Retourneert een lijst met datum/tijdzone-waarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde. |
List.Durations | Retourneert een lijst met duurwaarden van het aantal grootten, beginnend bij het begin en voegt een verhoging toe aan elke waarde. |
List.Generate | Hiermee wordt een lijst met waarden gegenereerd. |
List.Numbers | Retourneert een lijst met getallen uit het aantal grootten vanaf het begin en voegt een verhoging toe. De increment wordt standaard ingesteld op 1. |
List.Random | Retourneert een lijst met aantal willekeurige getallen, met een optionele seed-parameter. |
List.Times | Retourneert een lijst met tijdwaarden van het aantal grootten, beginnend bij het begin. |
Parameterwaarden
Specificatie van exemplaren
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
Sorteervolgorde
- Order.Ascending = 0;
- Order.Descending = 1;
Vergelijkingscriteria
Vergelijkingscriteria voor lijstwaarden kunnen worden opgegeven als:
- Een functiewaarde die een van de volgende is:
- Een sleutelkiezer die de waarde in de lijst bepaalt om de gelijkheidscriteria toe te passen.
- Een vergelijkingsfunctie die wordt gebruikt om het soort vergelijking op te geven dat moet worden toegepast. Ingebouwde vergelijkingsfuncties kunnen worden opgegeven: ga naar Comparer-functies.
- Een lijstwaarde met:
- Precies twee items.
- Het eerste element is de sleutelkiezer zoals hierboven is opgegeven.
- Het tweede element is een vergelijkingsfunctie zoals hierboven is opgegeven.
Ga naar List.Distinct voor meer informatie en voorbeelden.
Vergelijkingscriteria
Het vergelijkingscriterium kan worden opgegeven als een van de volgende waarden:
- Een getalwaarde om een sorteervolgorde op te geven. Ga naar Sorteervolgorde voor meer informatie.
- Als u een sleutel wilt berekenen die moet worden gebruikt voor sorteren, kunt u een functie van één argument gebruiken.
- Als u zowel een sleutel als een controlevolgorde wilt selecteren, kan het vergelijkingscriterium een lijst met de sleutel en volgorde zijn.
- Om de vergelijking volledig te beheren, kan een functie van twee argumenten worden gebruikt die -1, 0 of 1 retourneert op basis van de relatie tussen de linker- en rechterinvoer. Value.Compare is een methode die kan worden gebruikt om deze logica te delegeren.
Ga naar List.Sort voor meer informatie en voorbeelden.
Vervangingsbewerkingen
Vervangingsbewerkingen worden opgegeven door een lijstwaarde. Elk item van deze lijst moet het volgende zijn:
- Een lijstwaarde van precies twee items.
- Het eerste item is de oude waarde in de lijst die moet worden vervangen.
- Het tweede item is de nieuwe waarde, die alle exemplaren van de oude waarde in de lijst moet vervangen.