- 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));- 実装上の注意:
- この実装はスレッドに対して安全ではありません。 ただし、並列ストリームでCollectors.summarizingInt()を使用することは安全です。なぜなら、Stream.collect()の並列実装では、安全で効率的な並列実行のために必要な結果の分割、分離、およびマージが行われるからです。この実装では、合計のオーバーフローをチェックしません。 
- 導入されたバージョン:
- 1.8
 
- 
- 
コンストラクタのサマリーコンストラクタ コンストラクタ 説明 IntSummaryStatistics()ゼロ・カウント、ゼロ・サム、Integer.MAX_VALUEmin、Integer.MIN_VALUEmax、ゼロ平均を持つ空のインスタンスを構築します。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.Objectで宣言されたメソッドclone、equals、finalize、getClass、hashCode、notify、notifyAll、wait、wait、wait
 - 
インタフェース java.util.function.IntConsumerで宣言されたメソッドandThen
 
- 
 
- 
- 
- 
コンストラクタの詳細- 
IntSummaryStatisticspublic IntSummaryStatistics() ゼロ・カウント、ゼロ・サム、Integer.MAX_VALUEmin、Integer.MIN_VALUEmax、ゼロ平均を持つ空のインスタンスを構築します。
 - 
IntSummaryStatisticspublic IntSummaryStatistics(long count, int min, int max, long sum) throws IllegalArgumentException指定されたcount、min、max、およびsumで空でないインスタンスを構築します。countがゼロの場合、残りの引数は無視され、空のインスタンスが構築されます。引数が矛盾する場合は、 IllegalArgumentExceptionがスローされます。 必要な一貫した議論条件は次のとおりです:- count >= 0
- min <= max
 - APIの注:
- 引数の正しさの強化とは、IntSummaryStatisticsソース・インスタンスから取得した取得された記録値のセットが、ソース記録された値の算術オーバーフローのためにこのコンストラクタの引数の正当なセットでない可能性があることを意味します。 一貫した引数条件では、内部的に一貫性のないインスタンスの作成を防止するには十分ではありません。 このような状態の例は、:count= 2,min= 1,max= 2,およびsum= 0。
- パラメータ:
- count- 値の数
- min- 最小値
- max- 最大値
- sum- すべての値の合計
- 例外:
- IllegalArgumentException- 引数が矛盾する場合
- 導入されたバージョン:
- 10
 
 
- 
 - 
メソッドの詳細- 
acceptpublic void accept(int value) 新しい値をサマリー情報に記録します。- 定義:
- accept、インタフェース:- IntConsumer
- パラメータ:
- value- 入力値
 
 - 
combinepublic void combine(IntSummaryStatistics other) 別のIntSummaryStatisticsの状態をこれに結合します。- パラメータ:
- other- もう一方の- IntSummaryStatistics
- 例外:
- NullPointerException-- otherがnullである場合
 
 - 
getCountpublic final long getCount() 記録された値のカウントを返します。- 戻り値:
- 値の数
 
 - 
getSumpublic final long getSum() 記録された値の合計を返します。値が記録されていない場合は0を返します。- 戻り値:
- 値の合計。値がない場合はゼロ
 
 - 
getMinpublic final int getMin() 記録された最小値を返します。値が記録されていない場合はInteger.MAX_VALUEを返します。- 戻り値:
- 最小値。値がない場合はInteger.MAX_VALUE
 
 - 
getMaxpublic final int getMax() 記録された最大値を返します。値が記録されていない場合はInteger.MIN_VALUEを返します。- 戻り値:
- 最大値。値がない場合はInteger.MIN_VALUE
 
 - 
getAveragepublic final double getAverage() 記録された値の算術平均を返します。値が記録されていない場合は0を返します。- 戻り値:
- 値の算術平均。値がない場合はゼロ
 
 
- 
 
-