LongStream (java.util.stream API仕様 b128 非公式翻訳)

すべてのスーパーインタフェース:

AutoCloseable, BaseStream<Long,LongStream>
```
public interface LongStream
extends BaseStream<Long,LongStream>
```
プリミティブのlongである要素の列であり、逐次集計処理および並列集計処理を備える。これはプリミティブのlongに特化したStreamである。
次の例はStreamとLongStreamを使った集計処理を示し、赤いウィジェットの重さの和を計算する
```
 
    long sum = widgets.stream()
                      .filter(w -> w.getColor() == RED)
                      .mapToLong(w -> w.getWeight())
                      .sum();
```
更なるストリームの仕様・処理・ストリームパイプライン・並列性についてはStreamのクラスドキュメントとjava.util.streamのパッケージドキュメントを参照せよ。

ネストされたクラスの概要

ネストされたクラス
修飾子とタイプ	インタフェースと説明
`static interface`	`LongStream.Builder` `LongStream`の可変なビルダ `StreamBuilder`はライフサイクルを持ち、要素を追加できる構築中段階から始まり、要素を追加できなくなる構築済段階に移行する。

メソッドの概要

All Methods Static Methods Instance Methods Abstract Methods Default Methods
修飾子とタイプ	メソッドと説明
`boolean`	`allMatch(LongPredicate predicate)` このストリームの全ての要素が与えられた述語に適合するか返す。
`boolean`	`anyMatch(LongPredicate predicate)` このストリームのある要素が与えられた述語に適合するか返す。
`DoubleStream`	`asDoubleStream()` このストリームの要素を`double`に変換した要素からなる`DoubleStream`を返す。
`OptionalDouble`	`average()` このストリームの算術平均を表す`OptionalDouble`、またはこのストリームが空ならば空の`OptionalDouble`これは簡約の特別な場合である。
`Stream<Long>`	`boxed()` このストリームの要素を`Long`にボックス化した要素からなる`Stream`を返す。
`static LongStream.Builder`	`builder()` `LongStream`のビルダを返す。
`<R> R`	`collect(Supplier<R> supplier, ObjLongConsumer<R> accumulator, BiConsumer<R,R> combiner)` このストリームの要素に可変的簡約を実行する。
`static LongStream`	`concat(LongStream a, LongStream b)` ストリームの要素が、最初のストリームの全ての要素の後に2つ目のストリームの全ての要素を並べたような、遅延的に連結されたストリームを返す。
`long`	`count()` このストリームの要素数を返す。
`LongStream`	`distinct()` このストリームの要素のうち重複を除いた要素からなるストリームを返す。
`static LongStream`	`empty()` 空の逐次的`LongStream`を返す。
`LongStream`	`filter(LongPredicate predicate)` このストリームの要素のうち、与えられた述語に適合する要素からなるストリームを返す。
`OptionalLong`	`findAny()` このストリームのある要素を表す`OptionalLong`、もしくはストリームが空であれば空の`OptionalLong`を返す。
`OptionalLong`	`findFirst()` このストリームの最初の要素を表す`OptionalLong`、もしくはストリームが空であれば空の`OptionalLong`を返す。
`LongStream`	`flatMap(LongFunction<? extends LongStream> mapper)` 与えられた写像関数をこのストリームの各要素に適用して生成したストリームの内容で各要素を置き換えた結果からなるストリームを返す。
`void`	`forEach(LongConsumer action)` このストリームの各要素にアクションを適用する。
`void`	`forEachOrdered(LongConsumer action)` このストリームの各要素にアクションを適用する。
`static LongStream`	`generate(LongSupplier s)` 各要素が`LongSupplier`によって生成される、逐次的な無限ストリームを返す。
`static LongStream`	`iterate(long seed, LongUnaryOperator f)` 初期要素`seed`に対する関数`f`の繰り返しの適用によって生成された無限`LongStream`を返す。
`PrimitiveIterator.OfLong`	`iterator()` このストリームの要素のイテレータを返す。
`LongStream`	`limit(long maxSize)` このストリームの要素からなり、長さが`maxSize`より長くならないように切り詰められたストリームを返す。
`LongStream`	`map(LongUnaryOperator mapper)` このストリームの要素に与えられた関数を適用した結果からなるストリームを返す。
`DoubleStream`	`mapToDouble(LongToDoubleFunction mapper)` このストリームの要素に与えられた関数を適用した結果からなる`DoubleStream`を返す。
`IntStream`	`mapToInt(LongToIntFunction mapper)` このストリームの要素に与えられた関数を適用した結果からなる`IntStream`を返す。
`<U> Stream<U>`	`mapToObj(LongFunction<? extends U> mapper)` このストリームの要素に与えられた関数を適用した結果からなる、オブジェクトを値として持つ`Stream`を返す。
`OptionalLong`	`max()` このストリームの最大要素を表す`OptionalLong`、またはこのストリームが空ならば空の`OptionalLong`これは簡約の特殊な場合であり、次のコードと等しい。
`OptionalLong`	`min()` このストリームの最小要素を表す`OptionalLong`、またはこのストリームが空ならば空の`OptionalLong`これは簡約の特殊な場合であり、次のコードと等しい。
`boolean`	`noneMatch(LongPredicate predicate)` このストリームのどの要素も与えられた述語に適合しないか返す。
`static LongStream`	`of(long... values)` 要素が指定された値であるような逐次的なストリームを返す。
`static LongStream`	`of(long t)` 1つの要素を含む逐次的な`LongStream`を返す。
`LongStream`	`parallel()` 並列であり同等なストリームを返す。
`LongStream`	`peek(LongConsumer action)` このストリームの要素からなり、加えて結果のストリームから要素が消費されるごとにその要素にアクションを実行するストリームを返す。
`static LongStream`	`range(long startInclusive, long endExclusive)` `startInclusive`(この値を含む)から`endExclusive`(この値を含まない)まで、`1`ずつ増加する順序を持つ逐次的な`LongStream`を返す。
`static LongStream`	`rangeClosed(long startInclusive, long endInclusive)` `startInclusive`(この値を含む)から`endInclusive`(この値を含む)まで、`1`ずつ増加する順序を持つ逐次的な`LongStream`を返す。
`OptionalLong`	`reduce(LongBinaryOperator op)` 与えられた結合的な累積関数を使って、このストリームの要素に簡約処理を実行して簡約された値があればそれを表す`OptionalLong`を返す。
`long`	`reduce(long identity, LongBinaryOperator op)` 与えられた単位元と、結合的な累積関数を使って、このストリームの要素に簡約処理を実行して簡約された値を返す。
`LongStream`	`sequential()` 逐次的であり同等なストリームを返す。
`LongStream`	`skip(long n)` このストリームの`n`個の要素を取り除いた残りの要素からなるストリームを返す。
`LongStream`	`sorted()` このストリームの要素を、整列した結果からなるストリームを返す。
`Spliterator.OfLong`	`spliterator()` このストリームの要素のスプリッテレータを返す。
`long`	`sum()` このストリームの要素の和を返す。
`LongSummaryStatistics`	`summaryStatistics()` このストリームの要素の各種概要情報を表す`LongSummaryStatistics`を返す。
`long[]`	`toArray()` このストリームの要素からなる配列を返す。

インタフェースから継承されたメソッド BaseStream
close, isParallel, onClose, unordered

- メソッドの詳細
  - filter
```
LongStream filter(LongPredicate predicate)
```
    このストリームの要素のうち、与えられた述語に適合する要素からなるストリームを返す。
    これは中間処理である。
  - map
```
LongStream map(LongUnaryOperator mapper)
```
    このストリームの要素に与えられた関数を適用した結果からなるストリームを返す。
    これは中間処理である。
  - mapToObj
```
<U> Stream<U> mapToObj(LongFunction<? extends U> mapper)
```
    このストリームの要素に与えられた関数を適用した結果からなる、オブジェクトを値として持つStreamを返す。
    これは中間処理である。
  - mapToInt
```
IntStream mapToInt(LongToIntFunction mapper)
```
    このストリームの要素に与えられた関数を適用した結果からなるIntStreamを返す。
    これは中間処理である。
  - mapToDouble
```
DoubleStream mapToDouble(LongToDoubleFunction mapper)
```
    このストリームの要素に与えられた関数を適用した結果からなるDoubleStreamを返す。
    これは中間処理である。
  - flatMap
```
LongStream flatMap(LongFunction<? extends LongStream> mapper)
```
    与えられた写像関数をこのストリームの各要素に適用して生成したストリームの内容で各要素を置き換えた結果からなるストリームを返す。写像された各ストリームは、その内容がこのストリームに配置された後で閉じられる。(もし写像されたストリームがnullであれば、代わりに空のストリームが使われる)。
    これは中間処理である。
  - distinct
```
LongStream distinct()
```
    このストリームの要素のうち重複を除いた要素からなるストリームを返す。
    これは状態を持つ中間処理である。
  - sorted
```
LongStream sorted()
```
    このストリームの要素を、整列した結果からなるストリームを返す。
    これは状態を持つ中間処理である。
  - peek
```
LongStream peek(LongConsumer action)
```
    このストリームの要素からなり、加えて結果のストリームから要素が消費されるごとにその要素にアクションを実行するストリームを返す。
    これは中間処理である。
    並列ストリームパイプラインの場合、アクションは上流の処理から利用可能になった際に任意の時間と任意のスレッドで呼ばれる。もしアクションが共有状態を変更した場合、必要な同期を用意する必要がある。
  - limit
```
LongStream limit(long maxSize)
```
    このストリームの要素からなり、長さがmaxSizeより長くならないように切り詰められたストリームを返す。
    これは短絡的で状態を持つ中間処理である。
  - skip
```
LongStream skip(long n)
```
    このストリームのn個の要素を取り除いた残りの要素からなるストリームを返す。もしこのストリームがnより少ない要素を持つ場合、空のストリームが返される。
    これは状態を持つ中間処理である。
  - forEach
```
void forEach(LongConsumer action)
```
    このストリームの各要素にアクションを適用する。
    これは末端処理である。
    並列ストリームパイプラインの場合、この処理はストリームの出現順順序を尊重するとは限らない。そのようにしてしまうと並列処理の利点を犠牲にしてしまうためである。与えられた要素に対して、アクションはライブラリが選んだ任意の時間と任意のスレッドで実行される。もしアクションが共有状態を変更するならば、アクションは必要な同期処理を用意する責任を負う。
  - forEachOrdered
```
void forEachOrdered(LongConsumer action)
```
    このストリームの各要素にアクションを適用する。出現順順序が定義されているストリームに対しては各要素は出現順順序で実行されると保障する。
    これは末端処理である。
  - toArray
```
long[] toArray()
```
    このストリームの要素からなる配列を返す。
    これは末端処理である。
  - reduce
```
long reduce(long identity,
            LongBinaryOperator op)
```
    与えられた単位元と、結合的な累積関数を使って、このストリームの要素に簡約処理を実行して簡約された値を返す。これは次と等しい。
```
 
    long result = identity;
    for (long element : this stream)
        result = accumulator.applyAsLong(result, element)
    return result;
```
    ただし逐次的に実行されるとは制約されていない。
    値identityは累積関数の単位元である必要がある。つまり、任意のxに対してaccumulator.apply(identity, x)はxと等しい。accumulator関数は結合的関数である必要がある。
    これは末端処理である。
  - reduce
```
OptionalLong reduce(LongBinaryOperator op)
```
    与えられた結合的な累積関数を使って、このストリームの要素に簡約処理を実行して簡約された値があればそれを表すOptionalLongを返す。これは次と等しい。
```
 
    boolean foundAny = false;
    long result = null;
    for (long element : this stream) {
        if (!foundAny) {
            foundAny = true;
            result = element;
        }
        else
            result = accumulator.applyAsLong(result, element);
    }
    return foundAny ?OptionalLong.of(result) : OptionalLong.empty();
```
    ただし逐次的に実行されるとは制約されていない。
    accumulator関数は結合的関数である必要がある。
    これは末端処理である。
  - collect
```
<R> R collect(Supplier<R> supplier,
              ObjLongConsumer<R> accumulator,
              BiConsumer<R,R> combiner)
```
    このストリームの要素に可変的簡約を実行する。可変的簡約は、簡約した値がArrayListなどの可変な結果コンテナであるものであり、結果を置き換えるのではなく結果の状態を変更して各要素を組み入れるような簡約である。これは次のコードと同じ結果を生成する。
```
 
    R result = supplier.get();
    for (long element : this stream)
        accumulator.accept(result, element);
    return result;
```
    reduce(long, LongBinaryOperator)のように、collect処理は追加の同期処理を必要とせずに並列化できる。
    これは末端処理である。
  - sum
```
long sum()
```
    このストリームの要素の和を返す。これは簡約の特殊な場合であり、次のコードと等しい。
```
 
    return reduce(0, Long::sum);
```
    これは末端処理である。
  - min
```
OptionalLong min()
```
    このストリームの最小要素を表すOptionalLong、またはこのストリームが空ならば空のOptionalLongこれは簡約の特殊な場合であり、次のコードと等しい。
```
 
    return reduce(Long::min);
```
    これは末端処理である。
  - max
```
OptionalLong max()
```
    このストリームの最大要素を表すOptionalLong、またはこのストリームが空ならば空のOptionalLongこれは簡約の特殊な場合であり、次のコードと等しい。
```
 
    return reduce(Long::max);
```
    これは末端処理である。
  - count
```
long count()
```
    このストリームの要素数を返す。これは簡約の特殊な場合であり、次のコードと等しい。
```
 
    return map(e -> 1L).sum();
```
    これは末端処理である。
  - average
```
OptionalDouble average()
```
    このストリームの算術平均を表すOptionalDouble、またはこのストリームが空ならば空のOptionalDoubleこれは簡約の特別な場合である。
    これは末端処理である。
  - summaryStatistics
```
LongSummaryStatistics summaryStatistics()
```
    このストリームの要素の各種概要情報を表すLongSummaryStatisticsを返す。これは簡約の特別な場合である。
    これは末端処理である。
  - anyMatch
```
boolean anyMatch(LongPredicate predicate)
```
    このストリームのある要素が与えられた述語に適合するか返す。結果を特定するのに必要でなければ全ての要素に対しては述語を評価しない。このストリームが空であれば、述語は評価されず、falseを返す。
    これは短絡的で状態を持つ末端処理である。
  - allMatch
```
boolean allMatch(LongPredicate predicate)
```
    このストリームの全ての要素が与えられた述語に適合するか返す。結果を特定するのに必要でなければ全ての要素に対しては述語を評価しない。このストリームが空であれば、述語は評価されず、trueを返す。
    これは短絡的で状態を持つ末端処理である。
  - noneMatch
```
boolean noneMatch(LongPredicate predicate)
```
    このストリームのどの要素も与えられた述語に適合しないか返す。結果を特定するのに必要でなければ全ての要素に対しては述語を評価しない。このストリームが空であれば、述語は評価されず、trueを返す。
    これは短絡的で状態を持つ末端処理である。
  - findFirst
```
OptionalLong findFirst()
```
    このストリームの最初の要素を表すOptionalLong、もしくはストリームが空であれば空のOptionalLongを返す。このストリームが出現順順序を持たなければ任意の要素が返される場合がある。
    これは短絡的で状態を持つ末端処理である。
  - findAny
```
OptionalLong findAny()
```
    このストリームのある要素を表すOptionalLong、もしくはストリームが空であれば空のOptionalLongを返す。
    これは短絡的で状態を持つ末端処理である。
    この処理の動作は明示的に非決定的であり、どの要素を選んでもよい。これにより並列実行時の性能を最大化できる。その際のコストは同じ情報源に対する複数回の呼び出しが同じ値を返さないことである(もし安定した結果を望むならば、代わりにfindFirst()を用いよ)。
  - asDoubleStream
```
DoubleStream asDoubleStream()
```
    このストリームの要素をdoubleに変換した要素からなるDoubleStreamを返す。
    これは中間処理である。
  - boxed
```
Stream<Long> boxed()
```
    このストリームの要素をLongにボックス化した要素からなるStreamを返す。
    これは中間処理である。
  - sequential
```
LongStream sequential()
```
    インタフェースからコピーされた説明: BaseStream
    
    逐次的であり同等なストリームを返す。このストリームが既に逐次的であるため、または元のストリームの状態を逐次的であるように変更したため、このストリーム自身を返す場合がある。
    これは中間処理である。
    
    定義:
    
    sequential インタフェース内 BaseStream<Long,LongStream>
  - parallel
```
LongStream parallel()
```
    インタフェースからコピーされた説明: BaseStream
    
    並列であり同等なストリームを返す。このストリームが既に逐次的であるため、または元のストリームの状態を並列であるように変更したため、このストリーム自身を返す場合がある。
    これは中間処理である。
    
    定義:
    
    parallel インタフェース内 BaseStream<Long,LongStream>
  - iterator
```
PrimitiveIterator.OfLong iterator()
```
    インタフェースからコピーされた説明: BaseStream
    
    このストリームの要素のイテレータを返す。
    これは末端処理である。
    
    定義:
    
    iterator インタフェース内 BaseStream<Long,LongStream>
  - spliterator
```
Spliterator.OfLong spliterator()
```
    インタフェースからコピーされた説明: BaseStream
    
    このストリームの要素のスプリッテレータを返す。
    これは末端処理である。
    
    定義:
    
    spliterator インタフェース内 BaseStream<Long,LongStream>
  - builder
```
static LongStream.Builder builder()
```
    LongStreamのビルダを返す。
  - empty
```
static LongStream empty()
```
    空の逐次的LongStreamを返す。
  - of
```
static LongStream of(long t)
```
    1つの要素を含む逐次的なLongStreamを返す。
  - of
```
static LongStream of(long... values)
```
    要素が指定された値であるような逐次的なストリームを返す。
  - iterate
```
static LongStream iterate(long seed,
                          LongUnaryOperator f)
```
    初期要素seedに対する関数fの繰り返しの適用によって生成された無限LongStreamを返す。seed, f(seed), f(f(seed))などからなるLongStreamを生成する。
    LongStreamの最初の要素(位置0)はseedによって与えられる。n > 0に対しては、位置nの要素はfを位置n - 1の要素に適用した結果である。
  - generate
```
static LongStream generate(LongSupplier s)
```
    各要素がLongSupplierによって生成される、逐次的な無限ストリームを返す。定数のストリームや乱数のストリームなどを生成するのに向いている。
  - range
```
static LongStream range(long startInclusive,
                        long endExclusive)
```
    startInclusive(この値を含む)からendExclusive(この値を含まない)まで、1ずつ増加する順序を持つ逐次的なLongStreamを返す。
  - rangeClosed
```
static LongStream rangeClosed(long startInclusive,
                              long endInclusive)
```
    startInclusive(この値を含む)からendInclusive(この値を含む)まで、1ずつ増加する順序を持つ逐次的なLongStreamを返す。
  - concat
```
static LongStream concat(LongStream a,
                         LongStream b)
```
    ストリームの要素が、最初のストリームの全ての要素の後に2つ目のストリームの全ての要素を並べたような、遅延的に連結されたストリームを返す。結果のストリームは両方の入力ストリームが順序を持ては順序を持ち、どちらかの入力ストリームが並列であれば並列である。結果のストリームが閉じられた場合、両方の入力ストリームを閉じるハンドラが呼び出される。

インタフェース LongStream

ネストされたクラスの概要

メソッドの概要

インタフェースから継承されたメソッド BaseStream

メソッドの詳細

filter

map

mapToObj

mapToInt

mapToDouble

flatMap

distinct

sorted

peek

limit

skip

forEach

forEachOrdered

toArray

reduce

reduce

collect

sum

min

max

count

average

summaryStatistics

anyMatch

allMatch

noneMatch

findFirst

findAny

asDoubleStream

boxed

sequential

parallel

iterator

spliterator

builder

empty

of

of

iterate

generate

range

rangeClosed

concat