構文
List.PositionOf(
list as list,
value as any,
optional occurrence as nullable number,
optional equationCriteria as any
) as any
バージョン情報
指定した値がリストに表示されるオフセットを返します。 値が出現しない場合は、-1 が返されます。
-
list: 検索対象のリスト。 -
value: リスト内で検索する値。 -
occurrence: (省略可能) 報告する特定の出現箇所。 この値には、 Occurrence.First、 Occurrence.Last、または Occurrence.All を指定できます。occurrenceが指定されていない場合は、Occurrence.Firstが使用されます。 -
equationCriteria: (省略可能) 値を比較するときに等値を決定する方法を指定します。 このパラメーターには、キー セレクター関数、比較子関数、またはキー セレクターと比較子の両方を含むリストを指定できます。
例 1
リスト {1, 2, 3} 内で値 3 が出現する位置を求めます。
使用方法
List.PositionOf({1, 2, 3}, 3)
出力
2
例 2
2022 年の日付のすべてのインスタンスの一覧で位置を検索します。
使用方法
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
出力
{1, 3, 4}
例 3
単語 dog の最後の出現箇所のリスト内の位置を見つけます。大文字と小文字は区別されません。
使用方法
let
Source = List.PositionOf(
{"dog", "cat", "DOG", "pony", "bat", "rabbit", "dOG"},
"dog",
Occurrence.Last,
Comparer.OrdinalIgnoreCase
)
in
Source
出力
6
例 4
数値 28 の 2 単位以内にあるリスト内の位置を見つけます。
使用方法
let
Source = { 10, 15, 20, 25, 30 },
Position = List.PositionOf(
Source,
28,
Occurrence.First,
(x, y) => Number.Abs(x - y) <= 2
)
in
Position
出力
4