モジュール java.base
パッケージ java.util

インタフェースSpliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>

    • メソッドの詳細

      • trySplit

        T_SPLITR trySplit​()
        次のインタフェースからコピーされた説明: Spliterator
        このspliteratorをパーティション化できる場合に、要素に適用されるSpliteratorを返します。このメソッドから戻ると同時に、それらの要素にはこのSpliteratorが適用されなくなります。

        このスプリッテレータがSpliterator.ORDEREDである場合、返されるスプリッテレータは要素の厳密な接頭辞をカバーする必要があります。

        このスプリッテレータが無限の要素数をカバーする場合を除き、繰り返しtrySplit()を呼び出すと、最終的にはnullが返されるはずです。 null以外が返されたときは次のようになります。

        • 分割前にestimateSize()で報告される値は、分割後のこのスプリッテレータおよび返されたスプリッテレータのestimateSize()と等しいかそれより大きくなければなりません。さらに、
        • このスプリッテレータがSUBSIZEDである場合、分割前のこのスプリッテレータのestimateSize()は、分割後のこのスプリッテレータおよび返されたスプリッテレータのestimateSize()の合計と等しくなければなりません。

        このメソッドはなんらかの理由でnullを返す場合があります(空であるため、トラバース開始後に分割できないため、データ構造の制約のため、効率上の考慮事項のためなど)。

        定義:
        インタフェースSpliterator<T>のtrySplit
        戻り値:
        要素の一部分に適用されるSpliterator。このスプリッテレータを分割できない場合はnull

      • tryAdvance

        boolean tryAdvance​(T_CONS action)
        残りの要素が存在する場合は、指定されたアクションをそれに対して実行し、trueを返します。それ以外の場合はfalseを返します。 このスプリッテレータがSpliterator.ORDEREDである場合、検出順で次の要素に対してアクションが実行されます。 アクションによってスローされた例外は、呼出し側に中継されます。
        パラメータ:
        action - アクション
        戻り値:
        このメソッドに入ったときに、残りの要素が存在していなかった場合はfalse、それ以外の場合はtrue。
        例外:
        NullPointerException - 指定されたアクションがnullである場合

      • forEachRemaining

        default void forEachRemaining​(T_CONS action)
        すべての要素の処理が完了するかアクションから例外がスローされるまで、現在のスレッド内で残りの各要素に対して指定されたアクションをシーケンシャルに実行します。 このスプリッテレータがSpliterator.ORDEREDである場合、検出順にアクションが実行されます。 アクションによってスローされた例外は、呼出し側に中継されます。
        実装要件:
        デフォルト実装は、falseが返されるまで、繰り返しtryAdvance(T_CONS)を呼び出します。 可能な場合は常にオーバーライドしてください。
        パラメータ:
        action - アクション
        例外:
        NullPointerException - 指定されたアクションがnullである場合