Funciones de lista

Artículo
04/06/2023

Estas funciones crean y manipulan valores de lista.

Información

Nombre	Descripción
List.Count	Devuelve el número de elementos de una lista.
List.NonNullCount	Devuelve el número de elementos de una lista sin incluir los valores NULL.
List.IsEmpty	Devuelve si una lista está vacía.

Número de selección

Nombre	Descripción
List.Alternate	Devuelve una lista con los elementos alternativos de la lista original en función de un recuento, y de un parámetro repeatInterval y un desplazamiento opcionales.
List.Buffer	Almacena en búfer la lista en memoria. El resultado de esta llamada es una lista estable, lo cual significa que tendrá un recuento y un orden de elementos deterministas.
List.Distinct	Filtra una lista quitando los duplicados. Se puede especificar un valor opcional de criterios de ecuación para controlar la igualdad de la comparación. Se elige el primer valor de cada grupo de igualdad.
List.FindText	Busca un valor de texto en una lista de valores (incluidos los campos de registro).
List.First	Devuelve el primer valor de la lista, o el valor predeterminado especificado si está vacía. Devuelve el primer elemento de la lista, o el valor predeterminado opcional si la lista está vacía. Si la lista está vacía y no se especifica un valor predeterminado, la función devuelve un resultado.
List.FirstN	Devuelve el primer conjunto de elementos de la lista especificando cuántos elementos se tienen que devolver o mediante una condición proporcionada por `countOrCondition`.
List.InsertRange	Inserta elementos de los valores del índice especificado en la lista de entrada.
List.IsDistinct	Devuelve si una lista es diferente.
List.Last	Devuelve el último conjunto de elementos de la lista especificando cuántos elementos se tienen que devolver o mediante una condición proporcionada por `countOrCondition`.
List.LastN	Devuelve el último conjunto de elementos de la lista especificando cuántos elementos se tienen que devolver o mediante una condición.
List.MatchesAll	Devuelve true si todos los elementos de una lista cumplen una condición.
List.MatchesAny	Devuelve true si algún elemento de una lista cumple una condición.
List.Positions	Devuelve una lista de posiciones para una lista de entrada.
List.Range	Devuelve un recuento de elementos a partir de un desplazamiento.
List.Select	Selecciona los elementos que coinciden con una condición.
List.Single	Devuelve el único elemento de la lista o genera un error `Expression.Error` si la lista tiene más de un elemento.
List.SingleOrDefault	Devuelve un solo elemento de una lista.
List.Skip	Omite el primer elemento de la lista. Si la lista está vacía, devuelve una lista vacía. Esta función toma un parámetro opcional, `countOrCondition`, para poder omitir varios valores.

Funciones de transformación

Nombre	Descripción
List.Accumulate	Acumula un resultado de la lista. Aplica la función de acumulación a partir del primer valor de inicialización y devuelve el resultado final.
List.Combine	Combina una lista con listas en una sola lista.
List.ConformToPageReader	Esta función es solamente para uso interno.
List.RemoveRange	Devuelve una lista que quita los elementos de recuento a partir de un desplazamiento. El recuento predeterminado es 1.
List.RemoveFirstN	Devuelve una lista con el número especificado de elementos que se han quitado de la lista a partir del primer elemento. El número de elementos quitados depende del parámetro opcional `countOrCondition`.
List.RemoveItems	Quita los elementos de `list1` que están presentes en `list2` y devuelve una nueva lista.
List.RemoveLastN	Devuelve una lista con el número especificado de elementos que se han quitado de la lista a partir del último elemento. El número de elementos quitados depende del parámetro opcional `countOrCondition`.
List.Repeat	Devuelve una lista que repite el contenido de otra la lista de entrada un número de veces determinado.
List.ReplaceRange	Devuelve una lista que reemplaza los valores de recuento de una lista por una lista `replaceWith` que empieza en un índice.
List.RemoveMatchingItems	Quita todas las repeticiones de los valores especificados en la lista.
List.RemoveNulls	Quita los valores NULL de una lista.
List.ReplaceMatchingItems	Reemplaza las repeticiones de los valores existentes en la lista por valores nuevos mediante el valor `equationCriteria` proporcionado. Los parámetros `replacements` proporcionan los valores antiguos y los nuevos. Se puede especificar un valor opcional de criterios de ecuación para controlar la igualdad de la comparación. Para obtener más información sobre las operaciones de reemplazo y los criterios de ecuación, vaya a Valores de parámetros.
List.ReplaceValue	Busca un valor determinado en una lista de valores y sustituye cada coincidencia con el valor de reemplazo.
List.Reverse	Devuelve una lista que invierte los elementos de otra lista.
List.Split	Permite dividir la lista especificada en una lista de listas usando el tamaño de página especificado.
List.Transform	Aplica la función en cada elemento de la lista y devuelve una nueva lista.
List.TransformMany	Devuelve una lista cuyos elementos se proyectan a partir de la lista de entrada.

Funciones de pertenencia

Estas funciones se pueden usar con listas heterogéneas, ya que se puede comprobar la igualdad de todos los valores.

Nombre	Descripción
List.AllTrue	Devuelve true si todas las expresiones de la lista son verdaderas.
List.AnyTrue	Devuelve true si alguna expresión de la lista es verdadera.
List.Contains	Devuelve true si se encuentra un valor en una lista.
List.ContainsAll	Devuelve true si todos los elementos de los valores se encuentran en una lista.
List.ContainsAny	Devuelve true si alguno de los elementos de los valores se encuentra en una lista.
List.PositionOf	Busca la primera vez que aparece un valor en una lista y devuelve su posición.
List.PositionOfAny	Busca la primera vez que aparece cualquier valor en una lista de valores y devuelve su posición.

Operaciones de conjunto

Nombre	Descripción
List.Difference	Devuelve los elementos de la lista 1 que no están en la lista 2. Se admiten valores duplicados.
List.Intersect	Devuelve una lista a partir de una lista de listas y la intersección de los elementos comunes en listas individuales. Se admiten valores duplicados.
List.Union	Devuelve una lista a partir de una lista de listas y combina los elementos de las listas individuales. La lista devuelta contiene todos los elementos de cualquiera de las listas de entrada. Los valores duplicados se buscan como parte de la combinación.
List.Zip	Devuelve una lista de listas que combina los elementos situados en la misma posición.

Ordenación

Las funciones de ordenación realizan comparaciones. Todos los valores que se comparan deben ser comparables entre sí. Esto significa que deben proceder del mismo tipo de datos (o incluir NULL, que siempre se puede comparar). De lo contrario, se produce una excepción Expression.Error.

Los tipos de datos comparables incluyen los siguientes:

Number
Duration
DateTime
Texto
Lógicos
Null

Nombre	Descripción
List.Max	Devuelve el valor máximo de la lista, o el valor predeterminado opcional si la lista está vacía.
List.MaxN	Devuelve los valores máximos de una lista. Se debe especificar el número de valores que se va a devolver o una condición de filtrado.
List.Median	Devuelve el valor medio de una lista.
List.Min	Devuelve el valor mínimo de la lista, o el valor predeterminado opcional si la lista está vacía.
List.MinN	Devuelve los valores mínimos de una lista. Se puede especificar el número de valores que se va a devolver o una condición de filtrado.
List.Sort	Devuelve una lista ordenada mediante el criterio de comparación.
List.Percentile	Devuelve uno o varios percentiles de muestra que corresponden a las probabilidades dadas.

Promedios

Estas funciones se aplican a listas homogéneas de fechas y horas, números y duraciones.

Nombre	Descripción
List.Average	Devuelve un valor promedio de una lista, el cual es del mismo tipo de datos que los valores de la lista.
List.Mode	Devuelve el elemento más frecuente en una lista.
List.Modes	Devuelve todos los elementos que aparecen con la misma frecuencia máxima.
List.StandardDeviation	Devuelve la desviación estándar de una lista de valores. List.StandardDeviation realiza una estimación basada en una muestra. El resultado es un número para los valores numéricos y una duración para los valores de fecha y hora y las duraciones.

Suma

Estas funciones se aplican a listas homogéneas de números y duraciones.

Nombre	Descripción
List.Sum	Devuelve la suma de una lista.

Valores numéricos

Estas funciones solo se aplican a números.

Nombre	Descripción
List.Covariance	Devuelve la covarianza de dos listas como un número.
List.Product	Devuelve el producto de una lista de números.

Generadores

Estas funciones generan una lista de valores.

Nombre	Descripción
List.Dates	Devuelve una lista con un número determinado de valores de fecha a partir de un valor inicial, y agrega un incremento a cada valor.
List.DateTimes	Devuelve una lista con un número determinado de valores de fecha y hora a partir de un valor inicial, y agrega un incremento a cada valor.
List.DateTimeZones	Devuelve una lista con un número determinado de valores de fecha, hora y zona horaria a partir de un valor inicial, y agrega un incremento a cada valor.
List.Durations	Devuelve una lista con un número determinado de valores de duración a partir de un valor inicial, y agrega un incremento a cada valor.
List.Generate	Genera una lista de valores.
List.Numbers	Devuelve una lista con una cantidad determinada de números a partir de un valor inicial, y agrega un incremento a cada valor. El valor predeterminado del incremento es 1.
List.Random	Devuelve una lista con una cantidad determinada de números aleatorios, con un parámetro de inicialización opcional.
List.Times	Devuelve una lista con un número determinado de valores de hora a partir de un valor de inicio.

Valores de parámetros

Especificación de la repetición

Criterio de ordenación

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

Criterios de ecuación

Los criterios de ecuación para los valores de una lista se pueden especificar de dos maneras:

Un valor de función que es:
- Un selector de claves que determina el valor de la lista al que se aplicarán los criterios de igualdad.
- O bien, una función de comparador que se usa para especificar el tipo de comparación que se aplicará. Se pueden especificar las funciones de comparador integradas, vaya a Funciones de comparador.
Como un valor de lista que tiene:
- Exactamente dos elementos.
- Un primer elemento que es el selector de claves, tal y como se ha indicado anteriormente.
- Un segundo elemento que es un comparador, tal y como se ha indicado anteriormente.

Para obtener más información y ejemplos, vaya a List.Distinct.

Criterios de comparación

El criterio de comparación se puede proporcionar de las siguientes maneras:

Para especificar un criterio de ordenación, se puede usar un valor numérico. Para obtener más información, vaya a Criterio de ordenación.
Para calcular una clave que se va a usar para la ordenación, se puede usar una función de un argumento.
Para seleccionar una clave y un orden de control, el criterio de comparación puede ser una lista que contenga la clave y el orden.
Para controlar completamente la comparación, se puede usar una función de dos argumentos que devuelva -1 o 0 según la relación entre las entradas izquierda y derecha. Value.Compare es un método que se puede usar para delegar esta lógica.

Para obtener más información y ejemplos, vaya a List.Sort.

Operaciones de reemplazo

Las operaciones de reemplazo se especifican mediante un valor de lista. Cada elemento de esta lista debe ser:

Un valor de lista de exactamente dos elementos.
El primer elemento es el valor antiguo de la lista que se va a reemplazar.
El segundo elemento es el nuevo valor que debe reemplazar todas las repeticiones del valor antiguo en la lista.