List.PositionOf

Sintassi

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

Informazioni

Restituisce l'offset in corrispondenza del quale il valore specificato viene visualizzato in un elenco. Restituisce -1 se il valore non viene visualizzato.

• list: Elenco in cui cercare.
• value: valore da trovare nell'elenco.
• occurrence: (Facoltativo) Occorrenza specifica da segnalare. Questo valore può essere Occurrence.First, Occurrence.Last o Occurrence.All. Se non viene specificato alcun occurrence valore, Occurrence.First viene utilizzato .
• equationCriteria: (Facoltativo) Specifica la modalità di determinazione dell'uguaglianza durante il confronto dei valori. Questo parametro può essere una funzione selettore chiave, una funzione di confronto o un elenco contenente sia un selettore di chiave che un operatore di confronto.

Esempio 1

Trovare la posizione nell'elenco {1, 2, 3} in cui è presente il valore 3.

Utilizzo

List.PositionOf({1, 2, 3}, 3)

Output

2

Esempio 2

Trovare la posizione nell'elenco di tutte le istanze di date del 2022.

Utilizzo

let
    Source = {
        #date(2021, 5, 10),
        #date(2022, 6, 28),
        #date(2023, 7, 15),
        #date(2022, 12, 31),
        #date(2022, 4, 8),
        #date(2024, 3, 20)
    },
    YearList = List.Transform(Source, each Date.Year(_)),
    TargetYear = 2022,
    FindPositions = List.PositionOf(YearList, TargetYear, Occurrence.All)
in
    FindPositions

Output

{1, 3, 4}

Esempio 3

Trovare la posizione nell'elenco dell'ultima occorrenza della parola cane, ignorando le maiuscole.

Utilizzo

let
    Source = List.PositionOf(
        {"dog", "cat", "DOG", "pony", "bat", "rabbit", "dOG"}, 
        "dog", 
        Occurrence.Last, 
        Comparer.OrdinalIgnoreCase
    )
in
    Source

Output

6

Esempio 4

Trovare la posizione nell'elenco a una distanza massima di due unità dal numero 28.

Utilizzo

let
    Source = { 10, 15, 20, 25, 30 },
    Position = List.PositionOf(
        Source, 
        28,
        Occurrence.First, 
        (x, y) => Number.Abs(x - y) <= 2
    )
in
    Position

Output

4

Contenuto correlato

Criteri equazioni