compact1, compact2, compact3

java.util

クラスLongSummaryStatistics

java.lang.Object

java.util.LongSummaryStatistics

すべての実装されたインタフェース:

IntConsumer、LongConsumer

public class LongSummaryStatistics
extends Object
implements LongConsumer, IntConsumer

カウント数、最小、最大、合計、平均などの統計情報を収集するための状態オブジェクト。

このクラスは、streamsを扱う(必須ではないが)ために作られたものです。たとえば、以下を使用してlongのストリームのサマリー統計を計算できます。

 
 LongSummaryStatistics stats = longStream.collect(LongSummaryStatistics::new,
                                                  LongSummaryStatistics::accept,
                                                  LongSummaryStatistics::combine);
 

LongSummaryStatisticsは、streamのStream.collect(Collector)リダクション・ターゲットとして使用できます。たとえば、

 
 LongSummaryStatistics stats = people.stream()
                                     .collect(Collectors.summarizingLong(Person::getAge));

これは、単一パスで、人数、および年齢の最小、最大、合計および平均を計算します。

実装上の注意:

この実装はスレッドに対して安全ではありません。ただし、並列ストリームではCollectors.toLongStatistics()を使用するのが安全です。Stream.collect()の並列実装は、安全で効率的な並列実行のために必要な、結果のパーティション化、隔離、およびマージを提供するためです。

この実装では、合計のオーバーフローをチェックしません。

導入されたバージョン:

1.8

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
LongSummaryStatistics() ゼロ・カウント、ゼロ合計、Long.MAX_VALUE最小値、Long.MIN_VALUE最大値およびゼロ平均で空のインスタンスを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	accept(int value) 新しいint値をサマリー情報に記録します。
void	accept(long value) 新しいlong値をサマリー情報に記録します。
void	combine(LongSummaryStatistics other) 別のLongSummaryStatisticsの状態をこれに結合します。
double	getAverage() 記録された値の算術平均を返します。値が記録されていない場合は0を返します。
long	getCount() 記録された値のカウントを返します。
long	getMax() 記録された最大値を返します。値が記録されていない場合はLong.MIN_VALUEを返します。
long	getMin() 記録された最小値を返します。値が記録されていない場合はLong.MAX_VALUEを返します。
long	getSum() 記録された値の合計を返します。値が記録されていない場合は0を返します。
String	toString() オブジェクトの文字列表現を返します。

クラス java.lang.Objectから継承されたメソッド

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

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

andThen

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

andThen

コンストラクタの詳細

LongSummaryStatistics

public LongSummaryStatistics()

ゼロ・カウント、ゼロ合計、Long.MAX_VALUE最小値、Long.MIN_VALUE最大値およびゼロ平均で空のインスタンスを構築します。

メソッドの詳細

accept

public void accept(int value)

新しいint値をサマリー情報に記録します。

定義:

accept、インタフェース: IntConsumer

パラメータ:

value - 入力値

accept

public void accept(long value)

新しいlong値をサマリー情報に記録します。

定義:

accept、インタフェース: LongConsumer

パラメータ:

value - 入力値

combine

public void combine(LongSummaryStatistics other)

別のLongSummaryStatisticsの状態をこれに結合します。

パラメータ:

other - 別のLongSummaryStatistics

例外:

NullPointerException - otherがnullである場合

getCount

public final long getCount()

記録された値のカウントを返します。

戻り値:

値の数

getSum

public final long getSum()

記録された値の合計を返します。値が記録されていない場合は0を返します。

戻り値:

値の合計。値がない場合はゼロ

getMin

public final long getMin()

記録された最小値を返します。値が記録されていない場合はLong.MAX_VALUEを返します。

戻り値:

最小値、ない場合はLong.MAX_VALUE

getMax

public final long getMax()

記録された最大値を返します。値が記録されていない場合はLong.MIN_VALUEを返します。

戻り値:

最大値、ない場合はLong.MIN_VALUE

getAverage

public final double getAverage()

記録された値の算術平均を返します。値が記録されていない場合は0を返します。

戻り値:

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

toString

public String toString()

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

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

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

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

オーバーライド:

toString、クラス: Object

戻り値:

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