次の方法で共有


関数を一覧表示する

これらの関数は、リスト値を作成して操作します。

情報

名前 説明
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 値の一覧を生成します。

パラメーター値

発生の指定

並べ替え順序

数式の条件

リスト値の数式の条件は、次のいずれかとして指定できます。

  • 次のいずれかの関数値。
    • 等値条件を適用するリスト内の値を決定するキー セレクター。
    • 適用する比較の種類を指定するために使用される比較子関数。 組み込みの比較関数を指定できます。比較子関数 に移動します。
  • 次の値を持つリスト値。
    • ちょうど 2 つの項目。
    • 最初の要素は、上記で指定したキー セレクターです。
    • 2 番目の要素は、上記で指定した比較子です。

詳細と例については、「List.Distinct」を参照してください。

比較基準

比較条件は、次のいずれかの値として指定できます。

  • 並べ替え順序を指定する数値。 詳細については、「並べ替え順序」を参照してください
  • 並べ替えに使用するキーを計算するには、1 つの引数の関数を使用できます。
  • キーと制御順序の両方を選択するには、比較条件をキーと順序を含むリストを指定できます。
  • 比較を完全に制御するために、2 つの引数の関数を使用して、左と右の入力の関係を指定して -1、0、または 1 を返すことができます。 Value.Compare は、このロジックを委任するために使用できるメソッドです。

詳細と例については、「List.Sort」を参照してください。

置換操作

置換操作は、リスト値によって指定されます。 このリストの各項目は次の項目である必要があります。

  • 厳密に 2 つの項目のリスト値。
  • 最初の項目は、置き換えられるリスト内の古い値です。
  • 2 番目の項目は新しい値であり、リスト内の古い値のすべての出現箇所を置き換える必要があります。