関数を一覧表示する
これらの関数は、リスト値を作成して操作します。
情報
名前 | 説明 |
---|---|
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 | 長さが 1 のリストに対して 1 つのリスト項目を返し、それ以外の場合は例外をスローします。 |
List.SingleOrDefault | 長さ 1 のリストの 1 つのリスト 項目と、空のリストの既定値を返します。 |
List.Skip | リストの先頭にある指定した数の要素をスキップするリストを返します。 |
変換関数
名前 | 説明 |
---|---|
List.Accumulate | Aリスト内のアイテムの集計値を蓄積します。 |
List.Combine | 複数のリストを組み合わせて 1 つのリストを返します。 |
List.ConformToPageReader | この関数は、内部使用のみを目的としています。 |
List.RemoveFirstN | リストの先頭にある指定した数の要素をスキップするリストを返します。 |
List.RemoveItems | 2 番目のリストに存在する最初のリストから項目を削除します。 |
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 | 指定された 2 つのリストの差を返します。 |
List.Intersect | 入力で見つかったリスト値の積集合を返します。 |
List.Union | 入力で見つかったリスト値の和集合を返します。 |
順序付け
順序付け関数は比較を実行します。 比較されるすべての値は、互いに比較できる必要があります。 つまり、これらはすべて同じデータ型から取得する必要があります (または、常に最小の比較を行う null を含める)。 それ以外の場合は、Expression.Error
が投げられます。
同等のデータ型は次のとおりです。
- 数値
- 期間
- 日時
- テキスト
- 論理
- Null
名前 | 説明 |
---|---|
List.Max | 空のリストの最大値または既定値を返します。 |
List.MaxN | リスト内の最大値を返します。 返す値の数またはフィルター条件を指定する必要があります。 |
List.Median | リスト内の中央値を返します。 |
List.Min | 空のリストの最小値または既定値を返します。 |
List.MinN | リスト内の最小値を返します。 返す値の数またはフィルター条件を指定できます。 |
List.Sort | 指定した条件に従ってデータの一覧を並べ替えます。 |
List.Percentile | 特定の確率に対応する 1 つ以上のサンプルパーセンタイルを返します。 |
平均
これらの関数は、数値、DateTimes、および Duration の同種のリストに対して動作します。
名前 | 説明 |
---|---|
List.Average | 値の平均を返します。 数値、日付、日時、時区間、期間の値で動作します。 |
List.Mode | リスト内で最も頻繁に使用される値を返します。 |
List.Modes | リスト内で最も頻繁に使用される値の一覧を返します。 |
List.StandardDeviation | 標準偏差の標本ベースの推定値を返します。 この関数は、サンプル ベースの推定を実行します。 Numbers の結果は数値、DateTimes と Durations の結果は期間になります。 |
加算
これらの関数は、数値または期間の同種のリストに対して機能します。
名前 | 説明 |
---|---|
List.Sum | リスト内の項目の合計を返します。 |
数値
これらの関数は、数値に対してのみ機能します。
名前 | 説明 |
---|---|
List.Covariance | 数値の 2 つのリスト間の共分散を返します。 |
List.Product | リスト内の数値の積を返します。 |
発電 機
これらの関数は値のリストを生成します。
名前 | 説明 |
---|---|
List.Dates | 初期値、カウント、増分期間の値を指定して、date 値の一覧を生成します。 |
List.DateTimes | 初期値、カウント、増分期間の値を指定して、datetime 値の一覧を生成します。 |
List.DateTimeZones | 初期値、カウント、増分期間の値を指定して、datetimezone 値の一覧を生成します。 |
List.Durations | 初期値、カウント、増分期間の値を指定して、duration 値の一覧を生成します。 |
List.Generate | 値の一覧を生成します。 |
List.Numbers | 初期値、カウント、およびオプションのインクリメント値を指定して、数値のリストを返します。 |
List.Random | 乱数のリストを返します。 |
List.Times | 初期値、カウント、増分期間の値を指定して、time 値の一覧を生成します。 |
パラメーター値
発生の指定
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
並べ替え順序
- Order.Ascending = 0;
- Order.Descending = 1;
数式の条件
リスト値の数式の条件は、次のいずれかとして指定できます。
- 次のいずれかの関数値。
- 次の値を持つリスト値。
- ちょうど 2 つの項目。
- 最初の要素は、上記で指定したキー セレクターです。
- 2 番目の要素は、上記で指定した比較子です。
詳細と例については、「List.Distinct」を参照してください。
比較基準
比較条件は、次のいずれかの値として指定できます。
- 並べ替え順序を指定する数値。 詳細については、「並べ替え順序」を参照してください
- 並べ替えに使用するキーを計算するには、1 つの引数の関数を使用できます。
- キーと制御順序の両方を選択するには、比較条件をキーと順序を含むリストを指定できます。
- 比較を完全に制御するために、2 つの引数の関数を使用して、左と右の入力の関係を指定して -1、0、または 1 を返すことができます。 Value.Compare は、このロジックを委任するために使用できるメソッドです。
詳細と例については、「List.Sort」を参照してください。
置換操作
置換操作は、リスト値によって指定されます。 このリストの各項目は次の項目である必要があります。
- 厳密に 2 つの項目のリスト値。
- 最初の項目は、置き換えられるリスト内の古い値です。
- 2 番目の項目は新しい値であり、リスト内の古い値のすべての出現箇所を置き換える必要があります。