Funzioni di elenco

Queste funzioni creano e manipolano valori di elenco.

Informazioni

Nome	Descrizione
List.Count	Restituisce il numero di elementi in un elenco.
List.IsEmpty	Restituisce true se l'elenco è vuoto.
List.NonNullCount	Restituisce il numero di elementi non Null nell'elenco.

Selezione

Nome	Descrizione
List.Alternate	Restituisce un elenco costituito da tutti gli elementi di offset numerati dispari in un elenco.
List.Buffer	Memorizza nel buffer un elenco.
List.Distinct	Restituisce un elenco di valori con duplicati rimossi.
List.FindText	Restituisce un elenco di valori (inclusi i campi record) che contengono il testo specificato.
List.First	Restituisce il primo valore dell'elenco o, se vuoto, il valore predefinito specificato.
List.FirstN	Restituisce il primo set di elementi nell'elenco specificando il numero di elementi da restituire o una condizione idonea.
List.InsertRange	Inserisce valori in un elenco in corrispondenza dell'indice specificato.
List.IsDistinct	Indica se sono presenti duplicati nell'elenco.
List.Last	Restituisce l'ultimo valore dell'elenco o il valore predefinito specificato se vuoto.
List.LastN	Restituisce l'ultimo valore nell'elenco. Facoltativamente, è possibile specificare il numero di valori da restituire o una condizione idonea.
List.MatchesAll	Restituisce true se la funzione della condizione viene soddisfatta da tutti i valori nell'elenco.
List.MatchesAny	Restituisce true se la funzione della condizione viene soddisfatta da qualsiasi valore.
List.Positions	Restituisce un elenco di offset per l'input.
List.Range	Restituisce un subset dell'elenco a partire da un offset.
List.Select	Restituisce un elenco di valori che corrispondono alla condizione.
List.Single	Restituisce l'unica voce di elenco per un elenco di lunghezza 1, altrimenti genera un'eccezione.
List.SingleOrDefault	Restituisce l'unica voce di elenco per un elenco di lunghezza 1 e il valore predefinito per un elenco vuoto.
List.Skip	Restituisce un elenco che ignora il numero specificato di elementi all'inizio dell'elenco.

Funzioni di trasformazione

Nome	Descrizione
List.Accumulate	AAccumula un valore di riepilogo degli elementi nell'elenco.
List.Combine	Restituisce un singolo elenco combinando più elenchi.
List.ConformToPageReader	Questa funzione è solo per uso interno.
List.RemoveFirstN	Restituisce un elenco che ignora il numero specificato di elementi all'inizio dell'elenco.
List.RemoveItems	Rimuove gli elementi dal primo elenco presente nel secondo elenco.
List.RemoveLastN	Restituisce un elenco che rimuove il numero specificato di elementi dalla fine dell'elenco.
List.RemoveMatchingItems	Rimuove tutte le occorrenze dei valori di input.
List.RemoveNulls	Rimuove tutti i valori null dall'elenco specificato.
List.RemoveRange	Rimuove un certo numero di valori a partire dalla posizione specificata.
List.Repeat	Restituisce un elenco con count ripetizioni dell'elenco originale.
List.ReplaceMatchingItems	Sostituisce le occorrenze di valori esistenti nell'elenco con nuovi valori che corrispondono alla condizione.
List.ReplaceRange	Sostituisce un numero di valori count a partire da position con i valori sostitutivi.
List.ReplaceValue	Cerca in un elenco il valore specificato e lo sostituisce.
List.Reverse	Inverte l'ordine dei valori nell'elenco.
List.Split	Divide l'elenco specificato in un elenco di elenchi usando le dimensioni di pagina specificate.
List.Transform	Restituisce un nuovo elenco di valori calcolati da questo elenco.
List.TransformMany	Restituisce un elenco i cui elementi vengono trasformati dall'elenco di input utilizzando le funzioni specificate.
List.Zip	Restituisce un elenco di elenchi combinando gli elementi nella stessa posizione in più elenchi.

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 sono true.
List.AnyTrue	Restituisce "true" se qualsiasi espressione è "true".
List.Contains	Indica se l'elenco contiene il valore .
List.ContainsAll	Indica dove un elenco include tutti i valori in un altro elenco.
List.ContainsAny	Indica dove un elenco include uno dei valori in un altro elenco.
List.PositionOf	Restituisce gli offset di uno o più valori in un elenco.
List.PositionOfAny	Restituisce il primo offset di un valore in un elenco.

Operazioni su set

Nome	Descrizione
List.Difference	Restituisce la differenza tra i due elenchi specificati.
List.Intersect	Restituisce l'intersezione dei valori di elenco trovati nell'input.
List.Union	Restituisce l'unione dei valori dell'elenco trovati nell'input.

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 valore massimo o il valore predefinito per un 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 il valore mediano nell'elenco.
List.Min	Restituisce il valore minimo o il valore predefinito per un elenco vuoto.
List.MinN	Restituisce i valori minimi nell'elenco. È possibile specificare il numero di valori da restituire o una condizione di filtro.
List.Sort	Ordina un elenco di dati in base ai criteri specificati.
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 la media dei valori. Funziona con valori numerici, di data, di data e ora, di fuso orario e di durata.
List.Mode	Restituisce il valore più frequente nell'elenco.
List.Modes	Restituisce un elenco dei valori più frequenti nell'elenco.
List.StandardDeviation	Restituisce una stima basata su campione della deviazione standard. Questa funzione esegue una stima basata su esempio. 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 degli elementi nell'elenco.

Valori numerici

Queste funzioni operano solo sui numeri.

Nome	Descrizione
List.Covariance	Restituisce la covarianza tra i due elenchi di numeri.
List.Product	Restituisce il prodotto dei numeri nell'elenco.

Generatori

Queste funzioni generano un elenco di valori.

Nome	Descrizione
List.Dates	Genera un elenco di valori date dati un valore iniziale, un conteggio e un valore di durata incrementale.
List.DateTimes	Genera un elenco di valori datetime dati un valore iniziale, un conteggio e un valore di durata incrementale.
List.DateTimeZones	Genera un elenco di valori datetimezone dati un valore iniziale, un conteggio e un valore di durata incrementale.
List.Durations	Genera un elenco di valori duration dati un valore iniziale, un conteggio e un valore di durata incrementale.
List.Generate	Genera un elenco di valori.
List.Numbers	Restituisce un elenco di numeri in base a un valore iniziale, un conteggio e un valore di incremento facoltativo.
List.Random	Restituisce un elenco di numeri casuali.
List.Times	Genera un elenco di valori time dati un valore iniziale, un conteggio e un valore di durata incrementale.

Valori parametro

Specifica dell'occorrenza

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

Ordinamento

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

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.