列表函数

这些函数创建并操纵列表值。

信息

功能说明
List.Count返回列表中的项数。
List.NonNullCount返回列表中不包括 null 值的项数
List.IsEmpty返回列表是否为空。

选择

函数说明
List.Alternate返回列表，其中包含来自原始列表的基于 count、可选的 repeatInterval 和可选的 offset 交替变化的项。
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 将列表中现有值的匹配项替换为新值。 旧值和新值由替换参数提供。 可以指定可选相等条件值来控制相等比较。 有关替换操作和相等条件的详细信息，请参阅参数值。
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查找任何值在列表中的第一个匹配项，并返回其位置。

Set 运算

函数描述
List.Difference返回列表 1 中未出现在列表 2 中的项。 支持重复值。
List.Intersect从包含列表的一个列表中返回一个列表，并与单个列表中的常见项相交。 支持重复值。
List.Union从包含列表的一个列表中返回一个列表，并与单个列表中的项联合。 返回的列表包含任意输入列表中的所有项。 重复值会匹配为联合的一部分。
List.Zip返回包含在相同位置组合项的列表的一个列表。

中间件排序

排序函数执行比较操作。 所有被比较的值都必须互相进行比较。 这意味着这些值必须采用相同的数据类型（或包含始终经比较为最小的 null）。 否则，将引发 Expression.Error。

可比较的数据类型

  • Number

  • 持续时间

  • DateTime

  • Text

  • 逻辑

  • Null

函数描述
List.Max返回列表中的最大项；如果列表为空，则返回可选默认值。
List.MaxN返回列表中的最大值。 必须指定要返回的值的数量或筛选条件。
List.Median返回列表中的中位数项。
List.Min返回列表中的最小项；如果列表为空，则返回可选默认值。
List.MinN返回列表中的最小值。 可指定要返回的值的数量或筛选条件。
List.Sort使用比较条件返回已排序的列表。
List.Percentile返回与给定概率对应的一个或多个示例百分位数。
PercentileMode.ExcelExc在对 List.Percentile 内插值时，请使用与 Excel 的 PERCENTILE.EXC 兼容的方法。
PercentileMode.ExcelInc在对 List.Percentile 内插值时，请使用与 Excel 的 PERCENTILE.INC 兼容的方法。
PercentileMode.SqlCont在对 List.Percentile 内插值时，请使用与 SQL Server 的 PERCENTILE_CONT 兼容的方法。
PercentileMode.SqlDisc在对 List.Percentile 内插值时，请使用与 SQL Server 的 PERCENTILE_DISC 兼容的方法。

平均值

这些函数对数字、日期/时间和持续时间的同类列表执行操作。

函数描述
List.Average以列表中值的数据类型从列表中返回一个平均值。
List.Mode返回最常出现在列表中的项。
List.Modes返回以相同的最大频率出现的所有项。
List.StandardDeviation从值列表中返回标准偏差。 List.StandardDeviation 执行基于示例的估计。 结果是用于数字的一个数字以及用于日期/时间和持续时间的一个持续时间。

加法

这些函数适用于数字或持续时间的同类列表。

函数描述
List.Sum返回列表的总和。

数值

这些函数仅适用于数字。

函数描述
List.Covariance以数字形式返回两个列表的协方差。
List.Product从数字列表返回乘积。

生成器

这些函数会生成值列表。

函数描述
List.Dates从起点开始，根据大小计数返回日期值列表，并将每个值加上一个增量。
List.DateTimes从起点开始，根据大小计数返回日期/时间值列表，并将每个值加上一个增量。
List.DateTimeZones从起点开始，根据大小计数返回时区值列表，并将每个值加上一个增量。
List.Durations从起点开始，根据大小计数返回持续时间值列表，并将每个值加上一个增量。
List.Generate从值函数、条件函数、next 函数和值的可选转换函数生成列表。
List.Numbers从初始处开始，根据大小计数返回数字列表，并加上一个增量。 增量默认为 1。
List.Random返回计数随机数列表，其中包含可选的种子参数。
List.Times从起点开始，根据大小计数返回时间值列表。

参数值

匹配项规范

  • Occurrence.First = 0;

  • Occurrence.Last = 1;

  • Occurrence.All = 2;

排序顺序

  • Order.Ascending = 0;

  • Order.Descending = 1;

相等条件

可将列表值的相等条件指定为以下任一项

  • 一个函数值，它可以是

    • 一个键选择器，用于确定列表中要应用相等条件的值，或

    • 一个比较器函数，用于指定要应用的比较类型。 可以指定内置的比较器函数，请参阅“比较器函数”一节。

  • 一个列表值，此值

    • 正好有两项

    • 第一个元素是上面指定的键选择器

    • 第二个元素是上面指定的比较器。

有关详细信息和示例，请参阅 List.Distinct。

比较条件

可将比较条件提供为以下值之一：

  • 用于指定排序顺序的一个数字值。 有关详细信息，请参阅参数值的排序顺序。

  • 若要计算用于排序的键，可以使用具有 1 个参数的函数。

  • 若要选择键并控制顺序，比较条件可以是包含键和顺序的列表。

  • 若要完全控制比较，可以使用具有 2 个参数的函数，此函数将根据左输入和右输入之间的关系返回 -1、0 或 1。 Value.Compare 是可用于委托此逻辑的方法。

有关详细信息和示例，请参阅 List.Sort。

替换操作

替换操作由列表值指定，此列表中的每一项都必须为

  • 仅有两项的一个列表值

  • 第一项是列表中要替换的旧值

  • 第二项是新值，它应替换列表中出现的所有旧值

results matching ""

    No results matching ""