Leer en inglés

Compartir a través de


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

Criterio de ordenación

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.