- 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_VALUE
、最大値がInteger.MIN_VALUE
、平均値がゼロである空のインスタンスを構築します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 void
accept(int value)
新しい値をサマリー情報に記録しますvoid
combine(IntSummaryStatistics other)
別のIntSummaryStatistics
の状態をこれに結合します。double
getAverage()
記録された値の算術平均を返します。値が記録されていない場合は0を返します。long
getCount()
記録された値のカウントを返します。int
getMax()
記録された最大値を返します。値が記録されていない場合はInteger.MIN_VALUE
を返します。int
getMin()
記録された最小値を返します。値が記録されていない場合はInteger.MAX_VALUE
を返します。long
getSum()
記録された値の合計を返します。値が記録されていない場合は0を返します。String
toString()
デバッグに適しているこのオブジェクトの空ではない文字列表現を返します。-
インタフェースjava.util.function.IntConsumerから継承されたメソッド
andThen
-
-
-
-
メソッドの詳細
-
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を返します。- 戻り値:
- 値の算術平均。値がない場合はゼロ
-
-