- java.lang.Object
-
- java.util.IntSummaryStatistics
-
- すべての実装されたインタフェース:
IntConsumer
public class IntSummaryStatistics extends Object implements IntConsumer
カウント数、最小、最大、合計、平均などの統計情報を収集するための状態オブジェクト。このクラスは、streamsを扱う(必須ではないが)ために作られたものです。 たとえば、次を使って、int値のストリームに関するサマリー統計を計算することができます。
IntSummaryStatistics stats = intStream.collect(IntSummaryStatistics::new, IntSummaryStatistics::accept, IntSummaryStatistics::combine);IntSummaryStatisticsは、streamのリダクション・ターゲットとして使用できます。 たとえば:
これは、単一パスで、人数だけでなく、その扶養家族の最小値、最大値、合計、および平均値も計算します。IntSummaryStatistics stats = people.stream() .collect(Collectors.summarizingInt(Person::getDependents));- 実装上のノート:
- この実装はスレッドに対して安全ではありません。 ただし、
Stream.collect()のパラレル実装によって、安全で効率的なパラレル実行に必要なパーティション化、分離および結果のマージが提供されるため、パラレル・ストリームでCollectors.summarizingInt()を使用することは安全です。この実装では、合計のオーバーフローをチェックしません。
- 導入されたバージョン:
- 1.8
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 IntSummaryStatistics()ゼロカウント、ゼロ合計、Integer.MAX_VALUE最小、Integer.MIN_VALUE最大およびゼロ平均の空のインスタンスを構築します。IntSummaryStatistics(long count, int min, int max, long sum)指定されたcount、min、maxおよびsumを使用して、空でないインスタンスを構築します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 voidaccept(int value)新しい値をサマリー情報に記録します。voidcombine(IntSummaryStatistics other)別のIntSummaryStatisticsの状態をこれに結合します。doublegetAverage()記録された値の算術平均を返します。値が記録されていない場合は0を返します。longgetCount()記録された値のカウントを返します。intgetMax()記録された最大値を返します。値が記録されていない場合はInteger.MIN_VALUEを返します。intgetMin()記録された最小値を返します。値が記録されていない場合はInteger.MAX_VALUEを返します。longgetSum()記録された値の合計を返します。値が記録されていない場合は0を返します。StringtoString()デバッグに適しているこのオブジェクトの空ではない文字列表現を返します。-
クラスjava.langで宣言されたメソッド。オブジェクト
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
インタフェースjava.util.functionで宣言されたメソッド。IntConsumer
andThen
-
-
-
-
コンストラクタの詳細
-
IntSummaryStatistics
public IntSummaryStatistics()
ゼロカウント、ゼロ合計、Integer.MAX_VALUE最小、Integer.MIN_VALUE最大およびゼロ平均の空のインスタンスを構築します。
-
IntSummaryStatistics
public IntSummaryStatistics(long count, int min, int max, long sum) throws IllegalArgumentException指定されたcount、min、maxおよびsumを使用して、空でないインスタンスを構築します。countがゼロの場合、残りの引数は無視され、空のインスタンスが作成されます。引数に一貫性がない場合は、
IllegalArgumentExceptionがスローされます。 必要な一貫性のある引数条件は次のとおりです。count >= 0min <= max
- APIのノート:
- 引数の正確性の強制は、
IntSummaryStatisticsソース・インスタンスから取得された記録された値のセットが、ソースの記録された値数の算術オーバーフローのために、このコンストラクタの引数の有効なセットでない可能性があることを意味します。 一貫した引数条件では、内部的に一貫性のないインスタンスが作成されないようにするには不十分です。 このような状態の例として、count= 2、min= 1、max= 2およびsum= 0のインスタンスがあります。 - パラメータ:
count- 値の数min- 最小値max- 最大値sum- すべての値の合計- 例外:
IllegalArgumentException- 引数に一貫性がない場合- 導入されたバージョン:
- 10
-
-
メソッドの詳細
-
accept
public void accept(int value)
新しい値をサマリー情報に記録します。- 定義:
accept、インタフェースIntConsumer- パラメータ:
value- 入力値
-
combine
public void combine(IntSummaryStatistics other)
別のIntSummaryStatisticsの状態をこれに結合します。- パラメータ:
other- もう一方のIntSummaryStatistics- 例外:
NullPointerException-otherがnullである場合
-
getCount
public final long getCount()
記録された値のカウントを返します。- 戻り値:
- 値の数
-
getSum
public final long getSum()
記録された値の合計を返します。値が記録されていない場合は0を返します。- 戻り値:
- 値の合計。値がない場合はゼロ
-
getMin
public final int getMin()
記録された最小値を返します。値が記録されていない場合はInteger.MAX_VALUEを返します。- 戻り値:
- 最小値。値がない場合は
Integer.MAX_VALUE
-
getMax
public final int getMax()
記録された最大値を返します。値が記録されていない場合はInteger.MIN_VALUEを返します。- 戻り値:
- 最大値。値がない場合は
Integer.MIN_VALUE
-
getAverage
public final double getAverage()
記録された値の算術平均を返します。値が記録されていない場合は0を返します。- 戻り値:
- 値の算術平均。値がない場合はゼロ
-
-