List.Alternate

語法

List.Alternate(
    list as list,
    count as number,
    optional repeatInterval as nullable number,
    optional offset as nullable number
) as list

關於

透過交替保留與跳過 中的 list項目,返回一個新的清單。 這個函式會 offset 保留初始項目,然後反覆跳過 count 物品並保留 repeatInterval 物品。

  • count: 每次要跳過的項目數量。
  • repeatInterval:每次跳過後可選擇保留的項目數量。 如果沒有提供這個數值,那麼初始跳過之後的所有項目都會被保留。
  • offset:在重複跳過/保留模式開始前,可選擇保留的物品數量。 預設為零。

範例 1

建立一個跳過第一個數字的清單。

使用方式

List.Alternate({1..10}, 1)

輸出

{2, 3, 4, 5, 6, 7, 8, 9, 10}

範例 2

建立一個跳過每隔一個數字的清單。

使用方式

List.Alternate({1..10}, 1, 1)

輸出

{2, 4, 6, 8, 10}

範例 3

建立一個從1開始、跳過其他數字的清單。

使用方式

List.Alternate({1..10}, 1, 1, 1)

輸出

{1, 3, 5, 7, 9}

範例 4

建立一個從 1 開始、跳過一個值、保留兩個值,依此類推的清單。

使用方式

List.Alternate({1..10}, 1, 2, 1)

輸出

{1, 3, 4, 6, 7, 9, 10}