Condividi tramite

Funzioni di elenco

  • Articolo

Queste funzioni creano e manipolano valori di elenco.

Informazioni

Nome Descrizione
List.Count Restituisce il numero di elementi in un elenco.
List.NonNullCount Restituisce il numero di elementi in un elenco escludendo i valori Null.
List.IsEmpty Restituisce un valore che indica se un elenco è vuoto.

Selezione

Nome Descrizione
List.Alternate Restituisce un elenco con gli elementi alternati dall'elenco originale in base ai parametri count, repeatInterval facoltativo e offset facoltativo.
List.Buffer Memorizza l'elenco nel buffer in memoria. Il risultato della chiamata è un elenco stabile, che pertanto avrà un numero e un ordine di elementi deterministico.
List.Distinct Filtra un elenco riducendolo tramite la rimozione dei duplicati. È possibile specificare un valore dei criteri di uguaglianza facoltativo per controllare il confronto di uguaglianza. Viene scelto il primo valore di ogni gruppo di uguaglianza.
List.FindText Cerca un valore di testo in un elenco di valori, inclusi i campi di record.
List.First Restituisce il primo valore dell'elenco o, se vuoto, il valore predefinito specificato. Restituisce il primo elemento nell'elenco o il valore predefinito facoltativo se l'elenco è vuoto. Se l'elenco è vuoto e non viene specificato un valore predefinito, la funzione restituisce il controllo.
List.FirstN Restituisce il primo set di elementi dell'elenco specificando quanti elementi devono essere restituiti o una condizione idonea specificata da countOrCondition.
List.InsertRange Inserisce elementi dai valori in corrispondenza dell'indice specificato nell'elenco di input.
List.IsDistinct Restituisce un valore che indica se un elenco è distinto.
List.Last Restituisce l’ultimo set di elementi dell'elenco specificando quanti elementi devono essere restituiti o una condizione idonea specificata da countOrCondition.
List.LastN Restituisce l'ultimo set di elementi in un elenco specificando quanti elementi devono essere restituiti o una condizione idonea.
List.MatchesAll Restituisce true se tutti gli elementi in un elenco soddisfano una condizione.
List.MatchesAny Restituisce true se qualsiasi elemento in un elenco soddisfa una condizione.
List.Positions Restituisce un elenco di posizioni per un elenco di input.
List.Range Restituisce un numero specificato di elementi a partire da un offset.
List.Select Seleziona gli elementi che corrispondono a una condizione.
List.Single Restituisce il singolo elemento dell'elenco o genera un Expression.Error se l'elenco contiene più di un elemento.
List.SingleOrDefault Restituisce un singolo elemento da un elenco.
List.Skip Ignora il primo elemento dell'elenco. Dato un elenco vuoto, restituisce un elenco vuoto. Questa funzione accetta un parametro facoltativo, countOrCondition, per ignorare più valori.

Funzioni di trasformazione

Nome Descrizione
List.Accumulate Accumula un risultato dall'elenco. A partire dal valore di inizializzazione iniziale, questa funzione applica la funzione accumulatore e restituisce il risultato finale.
List.Combine Unisce un elenco di elenchi in un singolo elenco.
List.ConformToPageReader Questa funzione è solo per uso interno.
List.RemoveRange Restituisce un elenco che rimuove il numero di elementi specificati a partire dall'offset. Il numero predefinito è 1.
List.RemoveFirstN Restituisce un elenco con il numero specificato di elementi rimossi dall'elenco a partire dal primo elemento. Il numero di elementi rimossi dipende dal parametro countOrCondition facoltativo.
List.RemoveItems Rimuove gli elementi da list1 presenti in list2e restituisce un nuovo elenco.
List.RemoveLastN Restituisce un elenco con il numero specificato di elementi rimossi dall'elenco a partire dall'ultimo elemento. Il numero di elementi rimossi dipende dal parametro countOrCondition facoltativo.
List.Repeat Restituisce un elenco che ripete il contenuto di un elenco di input il numero di volte specificato da count.
List.ReplaceRange Restituisce un elenco che sostituisce il numero di valori specificato da count in un elenco con un elenco replaceWith a partire da un indice.
List.RemoveMatchingItems Rimuove tutte le occorrenze dei valori specificati nell'elenco.
List.RemoveNulls Rimuove i valori Null da un elenco.
List.ReplaceMatchingItems Sostituisce le occorrenze dei valori esistenti nell'elenco con i nuovi valori usando i criteri equationCriteria specificati. I valori vecchi e nuovi vengono forniti dai parametri replacements. È possibile specificare un valore dei criteri di uguaglianza facoltativo per controllare i confronti di uguaglianza. Per informazioni dettagliate sulle operazioni di sostituzione e sui criteri di uguaglianza, vedere Valori dei parametri.
List.ReplaceValue Ricerca nell'elenco di valori il valore e sostituisce ogni occorrenza con il valore di sostituzione.
List.Reverse Restituisce un elenco che inverte gli elementi in un elenco.
List.Split Divide l'elenco specificato in un elenco di elenchi usando le dimensioni di pagina specificate.
List.Transform Esegue la funzione su ogni elemento nell'elenco e restituisce il nuovo elenco.
List.TransformMany Restituisce l'elenco degli elementi previsti dall'elenco di input.

Funzioni di appartenenza

Poiché è possibile verificare l'uguaglianza di tutti i valori, queste funzioni possono operare su elenchi eterogenei.

Nome Descrizione
List.AllTrue Restituisce true se tutte le espressioni in un elenco sono true.
List.AnyTrue Restituisce true se un'espressione in un elenco è true.
List.Contains Restituisce true se viene trovato un valore in un elenco.
List.ContainsAll Restituisce true se tutti gli elementi nei valori vengono trovati in un elenco.
List.ContainsAny Restituisce true se un elemento nei valori viene trovato in un elenco.
List.PositionOf Trova la prima occorrenza di un valore in un elenco e ne restituisce la posizione.
List.PositionOfAny Trova la prima occorrenza di un valore in values e ne restituisce la posizione.

Operazioni su set

Nome Descrizione
List.Difference Restituisce gli elementi nell'elenco 1 che non sono presenti nell'elenco 2. Sono supportati valori duplicati.
List.Intersect Restituisce un elenco da un elenco di elenchi e interseca gli elementi comuni nei singoli elenchi. Sono supportati valori duplicati.
List.Union Restituisce un elenco da un elenco di elenchi e unisce gli elementi nei singoli elenchi. L'elenco restituito contiene tutti gli elementi in tutti gli elenchi di input. I valori duplicati vengono confrontati durante l'unione.
List.Zip Restituisce un elenco di elenchi combinando gli elementi nella stessa posizione.

Creazione dell'ordine

Le funzioni di ordinamento eseguono confronti. Tutti i valori confrontati devono essere confrontabili tra loro. Questo significa che devono essere tutti dello stesso tipo di dati (o includono Null e in questo caso per il confronto viene usato il più piccolo). In caso contrario, verrà generata un'eccezione Expression.Error.

I tipi di dati confrontabili includono:

  • Numero
  • Durata
  • Data/Ora
  • Testo
  • Logico
  • Null
Nome Descrizione
List.Max Restituisce il numero massimo di elementi in un elenco oppure il valore predefinito facoltativo se l'elenco è vuoto.
List.MaxN Restituisce i valori massimi nell'elenco. È necessario specificare il numero di valori da restituire o una condizione di filtro.
List.Median Restituisce l'elemento mediano da un elenco.
List.Min Restituisce l'elemento minimo in un elenco oppure il valore predefinito facoltativo se l'elenco è vuoto.
List.MinN Restituisce i valori minimi in un elenco. È possibile specificare il numero di valori da restituire o una condizione di filtro.
List.Sort Restituisce un elenco ordinato usando il criterio di confronto.
List.Percentile Restituisce uno o più percentili del campione corrispondenti alle probabilità specificate.

Medie

Queste funzioni operano su elenchi omogenei di valori di tipo number, datetime o duration.

Nome Descrizione
List.Average Restituisce un valore medio da un elenco nel tipo di dati dei valori nell'elenco.
List.Mode Restituisce un elemento che compare più di frequente in un elenco.
List.Modes Restituisce tutti gli elementi visualizzati con la stessa frequenza massima.
List.StandardDeviation Restituisce la deviazione standard da un elenco di valori. List.StandardDeviation esegue una stima basata su campione. Il risultato è un numero per i valori di tipo number e una durata per valori datetime e duration.

Addizione

Queste funzioni operano su elenchi omogenei di numeri o durate.

Nome Descrizione
List.Sum Restituisce la somma da un elenco.

Valori numerici

Queste funzioni operano solo sui numeri.

Nome Descrizione
List.Covariance Restituisce la covarianza da due elenchi sotto forma di numero.
List.Product Restituisce il prodotto da un elenco di numeri.

Generatori

Queste funzioni generano un elenco di valori.

Nome Descrizione
List.Dates Restituisce un elenco di valori di tipo date composto dal numero di valori specificato da count, a partire da start e aggiunge un incremento a ogni valore.
List.DateTimes Restituisce un elenco di valori di tipo datetime composto dal numero di valori specificato da count, a partire da start e aggiunge un incremento a ogni valore.
List.DateTimeZones Restituisce un elenco di valori di tipo datetimezone composto dal numero di valori specificato da count, a partire da start e aggiunge un incremento a ogni valore.
List.Durations Restituisce un elenco di valori di tipo duration composto dal numero di valori specificato da count, a partire da start e aggiunge un incremento a ogni valore.
List.Generate Genera un elenco di valori.
List.Numbers Restituisce un elenco di numeri composto dal numero di valori specificato da count, partendo da un valore iniziale e aggiungendo un incremento. Per impostazione predefinita, l'incremento è impostato su 1.
List.Random Restituisce un elenco di numeri casuali pari a count, con un parametro seed facoltativo.
List.Times Restituisce un elenco di valori di tipo time composto dal numero di valori specificato da count, a partire da start.

Valori parametro

Specifica dell'occorrenza

Ordinamento

Criteri di uguaglianza

I criteri di uguaglianza per i valori di elenco possono essere specificati come:

  • Valore di funzione che può essere:
    • Un selettore di chiave che determina il valore nell'elenco a cui applicare i criteri di uguaglianza.
    • Una funzione di confronto usata per specificare il tipo di confronto da applicare. È possibile specificare le funzioni di confronto predefinite. Passare a Funzioni di confronto.
  • Valore di elenco con:
    • Esattamente due elementi.
    • Il primo elemento è il selettore di chiave come specificato in precedenza.
    • Il secondo elemento è un operatore di confronto, come specificato in precedenza.

Per altre informazioni ed esempi, vedere List.Distinct.

Criteri di confronto

Il criterio di confronto può essere specificato con uno dei valori seguenti:

  • Valore numerico per specificare un ordinamento. Per Ulteriori informazioni, passare a Ordinare.
  • Per calcolare una chiave da usare per l'ordinamento, è possibile usare una funzione di 1 argomento.
  • Per selezionare sia una chiave che l'ordine, il criterio di confronto può essere un elenco contenente la chiave e l'ordine.
  • Per controllare completamente il confronto, è possibile usare una funzione di due argomenti che restituisce -1, 0 o 1 a seconda della relazione tra gli input di sinistra e di destra. Value.Compare è un metodo che può essere usato per delegare questa logica.

Per altre informazioni ed esempi, vedere List.Sort.

Operazioni di sostituzione

Le operazioni di sostituzione vengono specificate da un valore elenco. Ogni elemento dell'elenco deve essere:

  • Un valore elenco composto esattamente da due elementi.
  • Il primo elemento è il valore precedente nell'elenco, da sostituire.
  • Il secondo elemento è il nuovo valore che deve sostituire tutte le occorrenze del valore precedente nell'elenco.