shohaku.core.collections
クラス IteratorUtils

java.lang.Object
  拡張shohaku.core.collections.IteratorUtils

public class IteratorUtils
extends java.lang.Object

Iterator インタフェースのユーティリティメソッドを提供します。


コンストラクタの概要
IteratorUtils()
           
 
メソッドの概要
static java.util.Iterator arrayIterator(java.lang.Object a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(boolean[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(byte[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(char[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(java.lang.CharSequence cs)
          文字シーケンスの要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(double[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(java.util.Enumeration a)
          列挙を反復子のインタフェースに適合させて返却します。
static java.util.Iterator asIterator(float[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(int[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(long[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(java.lang.Object[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator asIterator(short[] a)
          配列の要素を反復する更新不可の反復子を生成して返却します。
static java.util.Iterator collectionIterator(java.lang.Object collection)
          オブジェクトをコレクションとして解析して推測させる妥当な反復子を生成して返却します。
static java.util.Iterator compositeIterator(java.util.Iterator[] is)
          複数の反復子を合成した反復子を生成して返却します。
static java.util.Iterator emptyIterator()
          空要素の反復子を生成して返却します。
static java.util.Iterator infiniteLoopIterator()
          無限に反復し null を返し続ける更新不可の反復子を生成して返却します。
static java.util.Iterator infiniteLoopIterator(java.lang.Object infiniteValue)
          無限に反復し infiniteValue を返し続ける更新不可の反復子を生成して返却します。
static java.util.Iterator predicateIterator(java.util.Iterator i, Predicate predicate)
          真偽を評価するクロージャが、真と評価する値のみを返す反復子を返却します。
static java.util.Iterator shift(java.util.Iterator i, int skipCount)
          指定された要素数を可能ならばスキップします。
static java.util.Iterator unextendsIterator(java.util.Iterator i)
          実装型に固有の機能へのアクセスを制限した反復子を返却します。
static java.util.Iterator unmodifiableIterator(java.util.Iterator i)
          更新不可の反復子に装飾して返却します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

IteratorUtils

public IteratorUtils()
メソッドの詳細

compositeIterator

public static java.util.Iterator compositeIterator(java.util.Iterator[] is)
複数の反復子を合成した反復子を生成して返却します。
配列インデックス順に全ての反復子を走査します。

パラメータ:
is - 合成する反復子の配列
戻り値:
複数の反復子を合成した反復子

emptyIterator

public static java.util.Iterator emptyIterator()
空要素の反復子を生成して返却します。

戻り値:
空要素の反復子

infiniteLoopIterator

public static java.util.Iterator infiniteLoopIterator()
無限に反復し null を返し続ける更新不可の反復子を生成して返却します。
この反復子は終了しません。 常に hasNext() == true を返しまた next() == null を返し続けます。

戻り値:
無限に反復する反復子

infiniteLoopIterator

public static java.util.Iterator infiniteLoopIterator(java.lang.Object infiniteValue)
無限に反復し infiniteValue を返し続ける更新不可の反復子を生成して返却します。
この反復子は終了しません。 常に hasNext() == true を返しまた next() == infiniteValue を返し続けます。

パラメータ:
infiniteValue - next() から無限回に返される値
戻り値:
無限に反復する反復子

arrayIterator

public static java.util.Iterator arrayIterator(java.lang.Object a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子
例外:
java.lang.IllegalArgumentException - 引数が配列以外の場合

asIterator

public static java.util.Iterator asIterator(java.lang.CharSequence cs)
文字シーケンスの要素を反復する更新不可の反復子を生成して返却します。
next() で返される要素は Character 型です。

パラメータ:
cs - 反復する文字シーケンス
戻り値:
文字シーケンスの要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(java.lang.Object[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(char[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(boolean[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(byte[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(short[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(int[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(long[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(float[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(double[] a)
配列の要素を反復する更新不可の反復子を生成して返却します。

パラメータ:
a - 反復する配列
戻り値:
配列の要素を反復する更新不可の反復子

asIterator

public static java.util.Iterator asIterator(java.util.Enumeration a)
列挙を反復子のインタフェースに適合させて返却します。
返却される反復子は更新不可と為ります。

パラメータ:
a - 列挙
戻り値:
列挙を反復子のインタフェースに適合させた更新不可の反復子

predicateIterator

public static java.util.Iterator predicateIterator(java.util.Iterator i,
                                                   Predicate predicate)
真偽を評価するクロージャが、真と評価する値のみを返す反復子を返却します。

パラメータ:
i - ラップする反復子
predicate - 真偽を評価するクロージャ
戻り値:
真と評価する値のみを返す反復子

unmodifiableIterator

public static java.util.Iterator unmodifiableIterator(java.util.Iterator i)
更新不可の反復子に装飾して返却します。

パラメータ:
i - ラップする反復子
戻り値:
更新不可の反復子

unextendsIterator

public static java.util.Iterator unextendsIterator(java.util.Iterator i)
実装型に固有の機能へのアクセスを制限した反復子を返却します。

パラメータ:
i - ラップする反復子
戻り値:
実装を装飾した反復子

collectionIterator

public static java.util.Iterator collectionIterator(java.lang.Object collection)
オブジェクトをコレクションとして解析して推測させる妥当な反復子を生成して返却します。
現在有効なデータ型は 配列、Collection、Enumeration、Iterator、Map、CharSequence と為ります。

パラメータ:
collection - 生成基のコレクション
戻り値:
コレクションの型から推測させる妥当な反復子

shift

public static java.util.Iterator shift(java.util.Iterator i,
                                       int skipCount)
指定された要素数を可能ならばスキップします。

パラメータ:
i - スキップする反復子
skipCount - 可能ならばスキップする要素数
戻り値:
引数の反復子の参照