La función List.PositionOf devuelve el índice de un elemento en una lista.
List.PositionOf(
list as list,
value as any,
optional occurrence as nullable number,
optional equationCriteria as any
) as any
- list: lista en la que realizar la búsqueda
- value: valor a buscar
- occurrence: (opcional) tipo de ocurrencia
- equationCriteria: (opcional) criterio de igualdad a aplicar a los elementos
Si el elemento buscado no se encuentra, la función devuelve el valor -1.
La búsqueda se realiza de izquierda a derecha. El primer elemento recibe el índice 0.
El tipo de ocurrencia puede ser:
Podemos obtener el índice del valor 1 en la lista {"a", 2, "b", 1, "a"} con la siguiente expresión:
List.PositionOf(
{"a", 2, "b", 1, "a"}, 1
)
3
Si el elemento buscado no se encuentra, la función devuelve -1:
List.PositionOf(
{"a", "b", "c"}, "d"
)
-1
Podemos controlar el tipo de ocurrencia. Por ejemplo, si especificamos como tercer argumento la constante Occurrence.First (o su equivalente numérico, 0), obtenemos el índice del primer elemento encontrado:
List.PositionOf(
{"a", "b", "a", "c", "b"},
"b",
Occurrence.First
)
1
Si, por el contrario, especificamos el argumento Occurrence.Last (o su equivalente numérico, 1), obtenemos el índice de la última aparición del elementos buscado:
List.PositionOf(
{"a", "b", "a", "c", "b"},
"b",
Occurrence.Last
)
4
Por último, si especificamos el argumento Occurrence.All (o su equivalente numérico, 2), obtenemos un listado con todas las ocurrencias del elemento buscado:
List.PositionOf(
{"a", "b", "a", "b", "b", "c", "b"}, "b", 2
)
List
Un clic en el enlace List nos devuelve la lista generada:
