Bagikan melalui


List.PositionOf

Sintaks

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

Tentang

Mengembalikan offset di mana nilai yang ditentukan muncul dalam daftar. Mengembalikan -1 jika nilai tidak muncul.

  • list: Daftar yang akan dicari.
  • value: Nilai yang akan ditemukan dalam daftar.
  • occurrence: (Opsional) Kemunculan spesifik untuk dilaporkan. Nilai ini dapat berupa Occurrence.First, Occurrence.Last, atau Occurrence.All. Jika tidak occurrence ditentukan, Occurrence.First digunakan.
  • equationCriteria: (Opsional) Menentukan bagaimana kesetaraan ditentukan saat membandingkan nilai. Parameter ini dapat menjadi fungsi pemilih kunci, fungsi pembanding, atau daftar yang berisi pemilih kunci dan pembanding.

Contoh 1

Temukan posisi dalam daftar {1, 2, 3} tempat nilai 3 muncul.

Penggunaan

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

Hasil

2

Contoh 2

Temukan posisi dari semua kemunculan tanggal dalam daftar dari tahun 2022.

Penggunaan

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

Hasil

{1, 3, 4}

Contoh 3

Temukan posisi dalam daftar kemunculan terakhir kata anjing, mengabaikan kasus.

Penggunaan

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

Hasil

6

Contoh 4

Temukan posisi dalam daftar yang berada dalam dua unit dari angka 28.

Penggunaan

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

Hasil

4

Kriteria persamaan