compact1, compact2, compact3

java.util

クラスIntSummaryStatistics

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.toIntStatistics()を使用することは安全です。これは、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.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

インタフェースjava.util.function.IntConsumerから継承されたメソッド

andThen

コンストラクタの詳細

IntSummaryStatistics

public IntSummaryStatistics()

カウントがゼロ、合計がゼロ、最小値がInteger.MAX_VALUE、最大値がInteger.MIN_VALUE、平均値がゼロである空のインスタンスを構築します。

メソッドの詳細

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を返します。

戻り値:

値の算術平均。値がない場合はゼロ

toString

public String toString()

次のクラスからコピーされた説明: Object

オブジェクトの文字列表現を返します。一般に、toStringメソッドは、このオブジェクトを「テキストで表す」文字列を返します。この結果は、人間が読める簡潔で有益な情報であるべきです。すべてのサブクラスで、このメソッドをオーバーライドすることをお薦めします。

クラスObjectのtoStringメソッドは、オブジェクトがインスタンスになっている元のクラスの名前、アットマーク文字「@」、およびオブジェクトのハッシュ・コードの符号なし16進数表現から構成される文字列を返します。つまり、このメソッドは次の値と等しい文字列を返します。

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

オーバーライド:

toString、クラス: Object

戻り値:

このオブジェクトの文字列表現