清單函式

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

資訊

名稱	描述
List.Count	傳回清單中的項目數。
List.NonNullCount	傳回清單中不含 null 值的項目數
List.IsEmpty	傳回清單是否為空的。

選取項目

名稱	描述
List.Alternate	傳回清單，其中項目會基於計數、選擇性 repeatInterval 及選擇性位移來以原始清單替代。
List.Buffer	將清單緩衝在記憶體中。 這個呼叫的結果為穩定清單，表示其會有確定的項目計數與順序。
List.Distinct	移除重複項目以篩選清單。 可以指定選擇性的方程式準則值，以控制等號比較測試。 系統會選擇每個相等群組的第一個值。
List.FindText	搜尋文字值的值清單，包括記錄欄位。
List.First	傳回清單的第一個值，如果為空白則會傳回指定預設值。 傳回清單中的第一個項目，如果清單為空白，則會傳回選擇性的預設值。 如果清單為空白，且未指定預設值，則函式會傳回。
List.FirstN	指定要傳回的項目數或 countOrCondition 提供的限定條件，以傳回清單中的第一組項目。
List.InsertRange	在輸入清單中，從指定索引處的值插入項目。
List.IsDistinct	傳回清單是否相異。
List.Last	指定要傳回的項目數或 countOrCondition 提供的限定條件，以傳回清單中的最後一組項目。
List.LastN	指定要傳回的項目數或限定條件，以傳回清單中的最後一組項目。
List.MatchesAll	如果清單中所有項目都符合條件，則會傳回 true。
List.MatchesAny	如果清單中的任何項目符合條件，則會傳回 true。
List.Positions	傳回輸入清單的位置清單。
List.Range	傳回從位移開始的計數項目。
List.Select	選取符合條件的項目。
List.Single	傳回清單的單一項目，如果清單中有一個以上的項目則擲回 Expression.Error。
List.SingleOrDefault	傳回清單中的單一項目。
List.Skip	略過清單的第一個項目。 指定空白清單，使其傳回空白清單。 此函式可接受選擇性的參數 countOrCondition，以支援跳過多個值。

轉換函式

名稱	描述
List.Accumulate	累計清單中的結果。 從初始值種子開始，此函式會套用累加器函式並傳回最終結果。
List.Combine	將複數清單中的清單合併成單一清單。
List.ConformToPageReader	這個函式僅供內部使用。
List.RemoveRange	傳回清單，該清單會移除從位移開始的計數項目。 預設計數為 1。
List.RemoveFirstN	傳回清單，該清單從第一個項目開始，將指定數目的項目從清單中移除。 已移除的元素數目，取決於選擇性 countOrCondition 參數。
List.RemoveItems	從 list1 中移除出現在 list2 中的項目，並傳回新的清單。
List.RemoveLastN	傳回清單，該清單從最後一個項目開始，將指定數目的項目從清單中移除。 已移除的元素數目，取決於選擇性 countOrCondition 參數。
List.Repeat	傳回清單，該清單會重複輸入清單計數次數的內容。
List.ReplaceRange	傳回清單，該清單會以從索引開始的 replaceWith 清單來取代清單中計數值。
List.RemoveMatchingItems	移除清單中所有出現的指定值。
List.RemoveNulls	從清單中移除 null 值。
List.ReplaceMatchingItems	使用提供的 equationCriteria，以新值取代清單中出現的現有值。 replacements 參數會提供新舊值。 可以指定選擇性的方程式準則值，以控制等號比較。 如需取代作業和方程式準則的詳細資料，請前往參數值。
List.ReplaceValue	搜尋值清單中的值，並在每次出現時以取代值取代。
List.Reverse	傳回清單，該清單會反轉清單中的項目。
List.Split	將所指定清單分割為一組使用特定頁面大小的清單。
List.Transform	在清單中的每個項目上執行該函式，並傳回新的清單。
List.TransformMany	傳回清單，其清單項目是從輸入清單投影而來。

成員資格函式

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

名稱	描述
List.AllTrue	如果清單中的所有運算式皆為 true，則會傳回 true
List.AnyTrue	如果清單中的任何運算式為 true，則會傳回 true
List.Contains	如果在清單中找到值，則會傳回 true。
List.ContainsAll	如果在清單中找到值的所有項目，則會傳回 true。
List.ContainsAny	如果在清單中找到值的任何項目，則會傳回 true。
List.PositionOf	在清單中尋找值的第一個出現位置，並傳回其位置。
List.PositionOfAny	在清單中尋找任何值的第一個出現位置，並傳回其位置。

集作業

名稱	描述
List.Difference	傳回在清單 1 但不在清單 2 中的項目。 支援重複值。
List.Intersect	從複數清單中傳回清單，並與個別清單中的一般項目交集。 支援重複值。
List.Union	從一連串清單中傳回清單，並與個別清單中的項目聯集。 傳回的清單會包含任何輸入清單中所有項目。 重複值會作為聯集的一部分進行比對。
List.Zip	傳回複數清單中的清單，該清單會合併位於相同位置的項目。

訂購

排序函式會執行比較。 所有接受比較的值都必須可以彼此互相比較， 這表示這些值必須全部來自相同的資料類型 (或包含 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.StandardDeviation 會執行以範例為基礎的估算。 若範例為數字則結果以數字顯示，若為日期時間和持續時間則以持續時間顯示。

加法

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

名稱	描述
List.Sum	從清單中傳回總和。

數值

這些函式僅適用於數字。

名稱	描述
List.Covariance	以數字形式傳回兩個清單的共變數。
List.Product	從數字清單傳回乘積。

產生器

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

名稱	描述
List.Dates	從大小計數傳回 date 值的清單，從初始值開始並針對每個值遞增。
List.DateTimes	從大小計數傳回 datetime 值的清單，從初始值開始並針對每個值遞增。
List.DateTimeZones	從大小計數傳回日期時區值的清單，從初始值開始並針對每個值遞增。
List.Durations	從大小計數傳回 duration 值的清單，從初始值開始並針對每個值遞增。
List.Generate	產生值清單。
List.Numbers	從大小計數傳回數字清單，該計數會從初始值開始遞增。 預設遞增為1。
List.Random	傳回帶有選擇性種子參數的計數亂數清單。
List.Times	傳回大小計數的時間值清單，從初始值開始。

參數值

Occurrence specification

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Occurrence.All = 2;

排列順序

• Order.Ascending = 0;
• Order.Descending = 1;

方程式準則

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

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

如需詳細資訊和範例，請前往 List.Distinct。

比較準則

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

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

如需詳細資訊和範例，請前往 List.Sort。

取代作業

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

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