トレーニング
List 関数
これらの関数を使用すると、リスト値の作成と操作を行えます。
名前 | Description |
---|---|
List.Count | リスト内の項目の数を返します。 |
List.NonNullCount | リスト内の項目の数を返します。null 値は除外されます |
List.IsEmpty | リストが空かどうかを返します。 |
名前 | Description |
---|---|
List.Alternate | 数、省略可能な repeatInterval、省略可能なオフセットに基づいて、元のリストから代替される項目を含むリストを返します。 |
List.Buffer | リストをメモリ内にバッファーします。 この呼び出しの結果は安定したリストになります。つまり、数と項目順が決定されます。 |
List.Distinct | 重複を削除して、リストをフィルター処理します。 省略可能な式条件値を指定して、等値比較を制御できます。 各等値グループの最初の値が選択されます。 |
List.FindText | レコード フィールドを含む、値のリスト内で、テキスト値を検索します。 |
List.First | リスト内の最初の値を返します。リストが空の場合は、指定された既定値を返します。 リスト内の最初の項目を返します。リストが空の場合は、省略可能な既定値を返します。 リストが空で、既定値が指定されていない場合、関数は null を返します。 |
List.FirstN | 返す項目の数、または countOrCondition に限定条件が指定されると、リスト内の最初の項目セットを返します。 |
List.InsertRange | 入力リスト内の指定されたインデックスの位置に値の項目を挿入します。 |
List.IsDistinct | リストが一意であるかどうかを返します。 |
List.Last | 返す項目の数、または countOrCondition に限定条件が指定されると、リスト内の最後の項目セットを返します。 |
List.LastN | 返す項目の数または限定条件が指定されると、リスト内の最後の項目セットを返します。 |
List.MatchesAll | リスト内のすべての項目が条件を満たしている場合に true を返します。 |
List.MatchesAny | リスト内のいずれかの項目が条件を満たしている場合に true を返します。 |
List.Positions | 入力リストに対して位置のリストを返します。 |
List.Range | オフセットの位置から始まる、count 個の項目を返します。 |
List.Select | 条件に一致する項目を選択します。 |
List.Single | リスト内の単一項目を返します。リストに複数の項目がある場合は、Expression.Error をスローします。 |
List.SingleOrDefault | リストから単一項目を返します。 |
List.Skip | リストの最初の項目をスキップします。 空のリストが指定されると、空のリストを返します。 この関数では、省略可能なパラメーター countOrCondition を受け取り、複数の値のスキップをサポートします。 |
名前 | Description |
---|---|
List.Accumulate | リストから結果を累積します。 この関数は、初期値のシードから開始し、アキュムレータ関数を適用し、最終的な結果を返します。 |
List.Combine | リストのリストを 1 つのリストにマージします。 |
List.ConformToPageReader | この関数は、内部での使用のみを意図しています。 |
List.RemoveRange | オフセットの位置から count 個の項目を削除したリストを返します。 既定のカウントは 1 です。 |
List.RemoveFirstN | リストの最初の要素から、指定された数の要素を削除したリストを返します。 削除されるエレメントの数は、省略可能なパラメーター countOrCondition によって決まります。 |
List.RemoveItems | list1 から、list2 に存在する項目を削除し、新しいリストを返します。 |
List.RemoveLastN | リストの最後の要素から、指定された数の要素を削除したリストを返します。 削除されるエレメントの数は、省略可能なパラメーター countOrCondition によって決まります。 |
List.Repeat | 入力リストの内容をカウント回数分繰り返すリストを返します。 |
List.ReplaceRange | リストのインデックスの位置から、count 個の値を 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
がスローされます。
比較可能なデータ型は次のとおりです。
- Number
- Duration
- DateTime
- Text
- 論理
- [Null]
名前 | 説明 |
---|---|
List.Max | リスト内の最大の項目を返します。リストが空の場合は、省略可能な既定値を返します。 |
List.MaxN | リスト内の最大値を返します。 返す値の数またはフィルター条件を指定する必要があります。 |
List.Median | リストから中央値の項目を返します。 |
List.Min | リスト内の最小の項目を返します。リストが空の場合は、省略可能な既定値を返します。 |
List.MinN | リスト内の最小値を返します。 返す値の数またはフィルター条件を指定できます。 |
List.Sort | 比較条件を使用して並べ替えられたリストを返します。 |
List.Percentile | 指定された確率に対応する 1 つまたは複数のサンプルのパーセンタイルを返します。 |
Numbers、DateTimes、および Durations の同種のリストを操作する関数です。
名前 | 説明 |
---|---|
List.Average | リストから、そのリスト内に指定されたデータ型の値の平均値を返します。 |
List.Mode | リスト内で最も多く出現する項目を 1 つ返します。 |
List.Modes | 最も多く出現する項目をすべて返します。 |
List.StandardDeviation | 値のリストから標準偏差を返します。 List.StandardDeviation は、サンプル ベースの推定を実行します。 Numbers の結果は数値、DateTimes と Durations の結果は期間になります。 |
Numbers または Durations の同種のリストを操作する関数です。
名前 | 説明 |
---|---|
List.Sum | リストから合計を返します。 |
数値のみを操作する関数です。
名前 | 説明 |
---|---|
List.Covariance | 2 つのリストの共分散を数値として返します。 |
List.Product | 数値のリストから積を返します。 |
値のリストを生成する関数です。
名前 | 説明 |
---|---|
List.Dates | count 個の date 値のリストを返します。開始値から始まり、値ごとに増分を加算します。 |
List.DateTimes | count 個の datetime 値のリストを返します。開始値から始まり、値ごとに増分を加算します。 |
List.DateTimeZones | count 個の datetimezone 値のリストを返します。開始値から始まり、値ごとに増分を加算します。 |
List.Durations | count 個の durations 値のリストを返します。開始値から始まり、値ごとに増分を加算します。 |
List.Generate | 値の一覧を生成します。 |
List.Numbers | count 個の数値のリストを返します。初期値から始まり、増分を加算します。 増分値は 1 です。 |
List.Random | count 個の乱数のリストを返します。シード パラメーターは省略可能です。 |
List.Times | 開始値から始まる count 個の時間値のリストを返します。 |
- Occurrence.First = 0;
- Occurrence.Last = 1;
- Occurrence.All = 2;
- Order.Ascending = 0;
- Order.Descending = 1;
リスト値の式の条件は、次のいずれかで指定できます。
- 次のいずれかの関数の値:
- 等値条件を適用するためのリストの値を決定するキー セレクター。
- 適用する比較の種類を指定ために使用される比較関数。 組み込みの比較関数を指定することができます。「比較関数」のセクションを参照してください。
- 次を含むリストの値:
- 厳密に 2 つの項目。
- 1 番目の要素は、上記で指定したキー セレクターです
- 2 番目の要素は、上記で指定した比較演算子です。
詳細と例については、「List.Distinct」を参照してください。
比較条件は、次のいずれかの値として指定できます。
- 並べ替え順序を指定する数値。 詳細については、「並べ替え順序」を参照してください
- 並べ替えに使用するキーを計算するには、引数が 1 つの関数を使用できます。
- キーと制御順序の両方を選択するには、キーと順序を含むリストを比較条件として指定できます。
- 比較を完全に制御するには、引数が 2 つである関数を使用できます。これにより、左右の入力の関係によって、-1、0、または 1 が返されます。 Value.Compare は、このロジックを委任するために使用できるメソッドです。
詳細と例については、「List.Sort」を参照してください。
置換操作は、リスト値によって指定されます。 リストの各項目は次を満たす必要があります。
- 厳密に 2 つの項目のリスト値。
- 1 番目の項目は、リスト内の古い値で、置き換えの対象です。
- 2 番目の項目は、リスト内の古い値のすべての出現箇所から置き換えられる新しい値です。