Funciones de lista
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
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
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.