Lijstfuncties
Met deze functies worden lijstwaarden gemaakt en bewerkt.
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. |
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 deterministisch aantal 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 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 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 true als een item in een lijst voldoet aan de voorwaarde. |
List.Positions | Retourneert een lijst met posities voor een invoerlijst. |
List.Range | Retourneert een aantal van items die beginnen bij een offset. |
List.Select | Selecteert de items die overeenkomen met een voorwaarde. |
List.Single | Retourneert het ene 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. Gegeven een lege lijst, retourneert het een lege lijst. Deze functie gebruikt een optionele parameter countOrCondition om het overslaan van meerdere waarden te ondersteunen. |
Naam | Beschrijving |
---|---|
List.Accumulate | Verzamelt een resultaat uit de lijst. De functie start met de beginwaarde, past de accumulatorfunctie toe en retourneert het uiteindelijke resultaat. |
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 waarbij een aantal items wordt verwijderd, beginnend vanaf een bepaalde beginpositie. 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 parameter countOrCondition . |
List.RemoveItems | Verwijder items uit list1 die aanwezig zijn in list2 en krijg een nieuwe lijst als resultaat. |
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 parameter countOrCondition . |
List.Repeat | Retourneert een lijst die de inhoud van een invoerlijst een aantal keer herhaalt. |
List.ReplaceRange | Retourneert een lijst die tellingswaarden in een lijst vervangt door een replaceWith lijst die begint bij een index. |
List.RemoveMatchingItems | Verwijdert alle voorkomens van de opgegeven waarden in de lijst. |
List.RemoveNulls | Hiermee verwijdert u null-waarden uit een lijst. |
List.ReplaceMatchingItems | Vervangt voorkomens van bestaande waarden in de lijst door nieuwe waarden met behulp van de opgegeven equationCriteria . Oude en nieuwe waarden worden geleverd door de replacements parameters. Er kan een optionele vergelijkingscriteriawaarde worden opgegeven om gelijkheidsvergelijkingen te beheren. Ga naar Parameterwaardenvoor meer informatie over vervangingsbewerkingen en vergelijkingscriteria. |
List.ReplaceValue | Zoekt in een lijst met waarden naar een bepaalde waarde en vervangt elke keer dat het voorkomt 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. |
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 | Geeft true terug als een expressie in de lijst waar is |
List.Contains | Retourneert true als een waarde wordt gevonden in een lijst. |
List.ContainsAll | Retourneert true als alle items in waarden in de lijst staan. |
List.ContainsAny | Retourneert waar als een item uit de waarden in een lijst aanwezig is. |
List.PositionOf | Vindt de eerste plaats van een waarde in een lijst en retourneert de positie ervan. |
List.PositionOfAny | Vindt het eerste exemplaar van een waarde in de opgegeven waarden en retourneert de positie. |
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. |
Functies voor ordenen 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 een Expression.Error
gegooid.
Vergelijkbare gegevenstypen zijn:
- Getal
- Duur
- Datum/tijd
- Tekst
- 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.Median | 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.Percentile | Retourneert een of meer percentielen die overeenkomen met de gegeven waarschijnlijkheden. |
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 schatting op basis van een voorbeeld uit. Het resultaat is een getal voor getallen en een duur voor datum/tijd en periodes. |
Deze functies werken via homogene lijsten met getallen of duur.
Naam | Beschrijving |
---|---|
List.Sum | Retourneert de som uit een lijst. |
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. |
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. |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Oplopend = 0;
- Order.Descending = 1;
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.Distinctvoor meer informatie en voorbeelden.
Het vergelijkingscriterium kan worden opgegeven als een van de volgende waarden:
- Een getalwaarde om een sorteervolgorde op te geven. Ga naar Sorteervolgordevoor 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.Sortvoor meer informatie en voorbeelden.
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, dat alle voorvallen van de oude waarde in de lijst moet vervangen.