La función List.Max devuelve el valor máximo de una lista.
List.Max(
list as list,
optional default as any,
optional comparisonCriteria as any,
optional includeNulls as nullable logical
) as any
- list: lista a evaluar
- default: (opcional) valor por defecto a devolver si la lista está vacía
- comparisonCriteria: (opcional) criterio de comparación de los elementos de la lista
- includeNulls: (opcional) parámetro no documentado
Si la lista está vacía, la función devuelve el valor null salvo que se incluya el parámetro default.
Si el parámetro comparisonCriteria toma el valor null, se utilizará el comparador por defecto.
En el caso de que existan en la lista elementos de varios tipos el orden de precedencia es el siguiente:
- Fechas
- Números
- Textos (según su codificación unicode: "A" < "a", "aA" < "aa")
Los booleanos son tratados como números (False = 0, True = 1).
La función conserva el tipo del valor devuelto.
Podemos obtener el valor máximo de la lista {5, 2, 7, -2} con la siguiente expresión:
List.Max(
{5, 2, 7, -2}
)
7
Si la lista está vacía, se devuelve el valor null:
List.Max(
{}
)
null
...salvo que se incluya un valor por defecto a devolver:
List.Max(
{},
-1
)
-1
Si la lista incluye elementos de varios tipos, se considera el orden de precedencia comentado:
List.Max(
{true, -2, "perro", "perra"}
)
perro
