Enumerar funciones

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.IsEmpty	Devuelve true si la lista está vacía.
List.NonNullCount	Devuelve el número de elementos que no son NULL en la lista.

Selección

Nombre	Descripción
List.Alternate	Devuelve una lista formada por todos los elementos de desplazamiento con numeración impar de una lista.
List.Buffer	Almacena en búfer una lista.
List.Distinct	Devuelve una lista de valores con duplicados quitados.
List.FindText	Devuelve una lista de valores (incluidos los campos de registro) que contienen el texto especificado.
List.First	Devuelve el primer valor de la lista o el valor predeterminado especificado si está vacío.
List.FirstN	Devuelve el primer conjunto de elementos de la lista especificando la cantidad de elementos a devolver o una condición de calificación.
List.InsertRange	Inserta valores en una lista en el índice especificado.
List.IsDistinct	Indica si hay duplicados en la lista.
List.Last	Devuelve el último valor de la lista o el valor predeterminado especificado si está vacío.
List.LastN	Devuelve el último valor de la lista. Opcionalmente, puede especificar cuántos valores se van a devolver o una condición apta.
List.MatchesAll	Devuelve true si todos los valores de la lista cumplen la función de condición.
List.MatchesAny	Devuelve true si cualquier valor cumple la función condition.
List.Positions	Devuelve una lista de desplazamientos para la entrada.
List.Range	Devuelve un subconjunto de la lista comenzando en un desplazamiento.
List.Select	Devuelve una lista de valores que coinciden con la condición.
List.Single	Devuelve el elemento de lista uno para una lista de longitud uno; de lo contrario, se inicia una excepción.
List.SingleOrDefault	Devuelve el único elemento de una lista de longitud uno y el valor predeterminado de una lista vacía.
List.Skip	Devuelve una lista que omite el número especificado de elementos al principio de la lista.

Funciones de transformación

Nombre	Descripción
List.Accumulate	AAccumula un valor de resumen de los elementos de la lista.
List.Combine	Devuelve una sola lista combinando varias listas.
List.ConformToPageReader	Esta función está pensada solo para uso interno.
List.RemoveFirstN	Devuelve una lista que omite el número especificado de elementos al principio de la lista.
List.RemoveItems	Quita los elementos de la primera lista que están presentes en la segunda lista.
List.RemoveLastN	Devuelve una lista que quita el número especificado de elementos del final de la lista.
List.RemoveMatchingItems	Quita todas las coincidencias de los valores de entrada.
List.RemoveNulls	Quita todos los valores de null de la lista especificada.
List.RemoveRange	Quita el número de recuento de valores a partir de la posición especificada.
List.Repeat	Devuelve una lista que es count repeticiones de la lista original.
List.ReplaceMatchingItems	Reemplaza las apariciones de los valores existentes en la lista por los nuevos valores que coinciden con la condición.
List.ReplaceRange	Reemplaza el número de valores count a partir de position por los valores de reemplazo.
List.ReplaceValue	Busca en una lista el valor especificado y lo reemplaza.
List.Reverse	Invierte el orden de los valores de la lista.
List.Split	Divide la lista especificada en una lista de listas con el tamaño de página especificado.
List.Transform	Devuelve una nueva lista de valores calculados a partir de esta lista.
List.TransformMany	Devuelve una lista cuyos elementos se transforman de la lista de entrada mediante funciones especificadas.
List.Zip	Devuelve una lista de listas combinando elementos en la misma posición en varias listas.

Funciones de pertenencia

Dado que todos los valores se pueden probar para obtener igualdad, estas funciones pueden funcionar en listas heterogéneas.

Nombre	Descripción
List.AllTrue	Devuelve true si todas las expresiones son verdaderas.
List.AnyTrue	Devuelve true si al menos una expresión es verdadera.
List.Contains	Indica si la lista contiene el valor.
List.ContainsAll	Indica dónde una lista incluye todos los valores de otra lista.
List.ContainsAny	Indica dónde una lista incluye cualquiera de los valores de otra lista.
List.PositionOf	Devuelve los desplazamientos de un valor en una lista.
List.PositionOfAny	Devuelve el primer desplazamiento de un valor en una lista.

Operaciones de conjunto

Nombre	Descripción
List.Difference	Devuelve la diferencia de las dos listas dadas.
List.Intersect	Devuelve la intersección de los valores de lista encontrados en la entrada.
List.Union	Devuelve la unión de los valores de lista encontrados en la entrada.

Pedido

Las funciones de ordenación realizan comparaciones. Todos los valores que se comparan deben ser comparables entre sí. Esto significa que todos deben provenir del mismo tipo de datos (o incluir null, que siempre compara los más pequeños). De lo contrario, se produce una excepción Expression.Error.

Entre los tipos de datos comparables se incluyen:

• Número
• Duración
• FechaHora
• Mensaje de texto
• Lógico
• Nulo

Nombre	Descripción
List.Max	Devuelve el valor máximo o el valor predeterminado de una lista vacía.
List.MaxN	Devuelve los valores máximos de la lista. Se debe especificar el número de valores que se van a devolver o una condición de filtrado.
List.Median	Devuelve el valor medio de la lista.
List.Min	Devuelve el valor mínimo o el valor predeterminado de una lista vacía.
List.MinN	Devuelve los valores mínimos de la lista. Se puede especificar el número de valores que se van a devolver o una condición de filtrado.
List.Sort	Ordena una lista de datos según los criterios especificados.
List.Percentile	Devuelve uno o varios percentiles de muestra correspondientes a las probabilidades dadas.

Promedios

Estas funciones funcionan en listas homogéneas de Números, DateTimes y Duraciones.

Nombre	Descripción
List.Average	Devuelve el promedio de los valores. Funciona con valores number, date, datetime, datetimezone y duration.
List.Mode	Devuelve el valor más frecuente de la lista.
List.Modes	Devuelve una lista de los valores más frecuentes de la lista.
List.StandardDeviation	Devuelve una estimación basada en muestras de la desviación estándar. Esta función realiza una estimación basada en ejemplo. 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.

Adición

Estas funciones funcionan sobre listas homogéneas de números o duraciones.

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

Valores numéricos

Estas funciones solo funcionan con números.

Nombre	Descripción
List.Covariance	Devuelve la covarianza entre las dos listas de números.
List.Product	Devuelve el producto de los números de la lista.

Generadores

Estas funciones generan una lista de valores.

Nombre	Descripción
List.Dates	Genera una lista de valores date dada un valor inicial, una cantidad y un valor de duración incremental.
List.DateTimes	Genera una lista de valores de datetime a partir de un valor inicial, una cantidad y un valor de duración incremental.
List.DateTimeZones	Genera una lista de valores datetimezone dado un valor inicial, una cantidad y un valor de duración incremental.
List.Durations	Genera una lista de valores de duration a partir de un valor inicial, una cantidad y un valor de duración incremental.
List.Generate	Genera una lista de valores.
List.Numbers	Devuelve una lista de números dado un valor inicial, un recuento y un valor de incremento opcional.
List.Random	Devuelve una lista de números aleatorios.
List.Times	Genera una lista de valores time dado un valor inicial, una cantidad y un valor de duración incremental.

Valores de parámetro

Especificación de ocurrencia

• 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 lista se pueden especificar como:

• Un valor de función que es:
  • Selector principal que determina el valor en la lista para aplicar los criterios de igualdad.
  • Función del comparador que se usa para especificar el tipo de comparación que se va a aplicar. Se pueden especificar las funciones de comparador integradas; ve a Funciones de comparador.
• Como un valor de lista que tiene:
  • Exactamente dos elementos.
  • El primer elemento es el selector de claves tal y como se especificó anteriormente.
  • El segundo elemento es un comparador como se especificó 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 como cualquiera de los siguientes valores:

• Valor numérico para especificar un criterio de ordenación. Para obtener más información, ve a Criterio de ordenación.
• Para calcular una clave que se va a usar para ordenar, 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 devuelve -1, 0 o 1 dada 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 anterior de la lista, que se va a reemplazar.
• El segundo elemento es el nuevo valor, que debe reemplazar todas las apariciones del valor anterior en la lista.