List.PositionOf

La función List.PositionOf devuelve el índice de un elemento en una lista.

Sintaxis

List.PositionOf(
    list as list,
    value as any,
    optional occurrence as nullable number,
    optional equationCriteria as any
) as any

Parámetros
  • 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
Información adicional

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:

Ejemplos

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

Función M List.PositionOf

Si el elemento buscado no se encuentra, la función devuelve -1:

List.PositionOf(
    {"a", "b", "c"}, "d"
)

-1

Función M List.PositionOf

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

Función M List.PositionOf

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

Función M List.PositionOf

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

Función M List.PositionOf

Un clic en el enlace List nos devuelve la lista generada:

Función M List.PositionOf
Categoría
Funciones de lista
Submitted by admin on Tue, 07/28/2020 - 20:14