共用方式為

清單函式

  • 發行項

這些函式會建立及操作清單值。

資訊

名稱 描述
List.Count 傳回清單中的項目數。
List.IsEmpty 如果清單是空的，則傳回 true。
List.NonNullCount 傳回清單中非 Null 項目的數目。

選取項目

名稱 描述
List.Alternate 傳回清單，其中包含清單中所有奇數位移元素。
List.Buffer 緩衝清單。
List.Distinct 返回一個已移除重複值的值列表。
List.FindText 傳回包含指定文字的值清單（包括記錄欄位）。
List.First 傳回清單的第一個值，如果為空白則會傳回指定預設值。
List.FirstN 指定要傳回多少項目或符合條件，以傳回清單中的第一組項目。
List.InsertRange 將值插入指定索引處的清單。
List.IsDistinct 指出清單中是否有重複專案。
List.Last 傳回清單的最後一個值，如果為空白，則傳回指定的預設值。
List.LastN 傳回清單中的最後一個值。 可以選擇性地指定要傳回多少值或限定條件。
List.MatchesAll 如果清單中的所有值都滿足條件函式，則傳回 true。
List.MatchesAny 如果條件函式符合任何值，則傳回 true。
List.Positions 傳回輸入資料的偏移量清單。
List.Range 傳回從指定位移開始的清單子集。
List.Select 傳回符合條件的值清單。
List.Single 傳回一份長度清單的清單項目，否則會擲回例外狀況。
List.SingleOrDefault 傳回長度為一的清單中唯一的專案，若清單為空則傳回預設值。
List.Skip 傳回清單，略過清單開頭的指定項目數目。

轉換函式

名稱 描述
List.Accumulate 累積清單中項目的總值。
List.Combine 結合多個清單，傳回單一清單。
List.ConformToPageReader 這個函式僅供內部使用。
List.RemoveFirstN 傳回清單，略過清單開頭的指定項目數目。
List.RemoveItems 移除第一個清單中在第二個清單中出現的項目。
List.RemoveLastN 傳回清單，從清單結尾移除指定的項目數目。
List.RemoveMatchingItems 移除所有輸入值的出現次數。
List.RemoveNulls 從指定的清單中移除所有 null 值。
List.RemoveRange 拿掉從指定位置開始的值計數。
List.Repeat 傳回一個清單，是原始清單重複 count 次的結果。
List.ReplaceMatchingItems 以符合條件的新值取代清單中現有值的出現次數。
List.ReplaceRange 將從 position 開始的 count 個值替換為替換值。
List.ReplaceValue 搜尋清單以尋找指定的值，並取代它。
List.Reverse 反轉清單中的值順序。
List.Split 將所指定清單分割為一組使用特定頁面大小的清單。
List.Transform 傳回從這個清單計算的新值清單。
List.TransformMany 傳回一個清單，其元素會使用指定的函數從輸入清單中轉換。
List.Zip 傳回一個清單的清單，藉由合併多個清單中相同位置的項目。

成員資格函式

因為所有的值都可以進行相等測試，所以這些函式可以在異質清單上運作。

名稱 描述
List.AllTrue 如果所有表達式都為 true，則傳回 true。
List.AnyTrue 如果有任何表達式為 true，則傳回 true。
List.Contains 指示清單是否包含值。
List.ContainsAll 指出清單包含另一個清單中所有值的位置。
List.ContainsAny 指出清單包含另一個清單中任何值的位置。
List.PositionOf 傳回清單中某個值的偏移量。
List.PositionOfAny 傳回清單中值的第一個位移。

集作業

名稱 描述
List.Difference 傳回兩個指定清單的差異。
List.Intersect 傳回輸入中找到的清單值交集。
List.Union 傳回輸入中找到的清單值聯集。

訂購

排序函式會執行比較。 所有接受比較的值都必須可以彼此互相比較， 這表示這些值必須全部來自相同的資料類型 (或包含 null，使其一律進行最小比較)， 否則會擲回 Expression.Error。

可比較的資料類包含：

  • 數值
  • 期間
  • Datetime
  • Text
  • 邏輯
  • Null
名稱 描述
List.Max 傳回空清單的最大值或預設值。
List.MaxN 傳回清單中的最大值。 必須指定要傳回的值數目或篩選條件。
List.Median 傳回清單中的中位數值。
List.Min 傳回空白清單的最小值或預設值。
List.MinN 傳回清單中的最小值。 可以指定要傳回的值數目或篩選條件。
List.Sort 根據指定的準則排序數據清單。
List.Percentile 傳回一或多個對應到指定機率的樣本百分位數。

平均值

這些函式適用於數字、日期時間和持續時間的同質清單。

名稱 描述
List.Average 傳回值的平均值。 適用於數字、日期、日期時間、日期時間區域和持續時間的值。
List.Mode 傳回清單中最常見的值。
List.Modes 傳回清單中最常見值的清單。
List.StandardDeviation 傳回以標準偏差為基礎的樣本估計值。 此函式會執行以範例為基礎的估計值。 若範例為數字則結果以數字顯示，若為日期時間和持續時間則以持續時間顯示。

加法

這些函式適用於數字或持續時間的同質清單。

名稱 描述
List.Sum 傳回清單中的項目總和。

數值

這些函式僅適用於數字。

名稱 描述
List.Covariance 傳回兩個數值列表之間的共變異數。
List.Product 傳回清單中的數位乘積。

產生器

這些函式會產生值的清單。

名稱 描述
List.Dates 根據初始值、計數和遞增的持續時間值，生成一個 date 值列表。
List.DateTimes 根據初始值、計數和累加持續時間值，產生 datetime 值的清單。
List.DateTimeZones 根據初始值、數量和逐步增加的持續時間值，產生 datetimezone 值的列表。
List.Durations 根據初始值、計數和增量持續時間值，生成 duration 值的列表。
List.Generate 產生值清單。
List.Numbers 傳回指定初始值、計數和選擇性遞增值的數字清單。
List.Random 傳回隨機數的清單。
List.Times 根據初始值、數量和增量持續時間值，生成 time 值的列表。

參數值

Occurrence specification

排列順序

方程式準則

清單值的方程式準則可以指定為下列兩者其一：

  • 函式值，其為：
    • 索引鍵選取器，決定清單中要套用相等準則的值。
    • 用來指定要所套用比較類型的比較子函式。 可以指定內建的比較子函式，請前往比較子函式。
  • 具有下列項目的清單值：
    • 剛好兩個項目。
    • 第一個元素是如上指定的索引鍵選取器。
    • 第二個項目是如上所述的的比較子。

如需詳細資訊和範例，請移至 List.Distinct。

比較準則

比較準則可以提供為下列其中一個值：

  • 用來指定排序次序的數字值。 如需詳細資訊，請前往排序順序。
  • 若要計算要用於排序的索引鍵，可以使用一個引數的函式。
  • 若要同時選取索引鍵和控制順序，比較準則可以作為包含索引鍵和順序的清單。
  • 若要完全控制比較，可以使用兩個引數的函式，您可以指定左右輸入之間的關聯性，使該函式傳回 -1、0 或 1。 Value.Compare 是可用來委派此邏輯的方法。

如需詳細資訊和範例，請移至 List.Sort。

取代作業

取代作業是由清單值所指定。 此清單的每個項目都必須是：

  • 剛好兩個項目的清單值。
  • 第一個項目為清單中要取代的舊值。
  • 第二個項目為新值，其應該要取代清單中所有出現的舊值。