shohaku.core.collections
クラス ComparatorUtils

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

public class ComparatorUtils
extends java.lang.Object

順序付け比較のユーティリティメソッドを提供します。


コンストラクタの概要
ComparatorUtils()
           
 
メソッドの概要
static int compare(java.util.Collection comps, java.util.Collection comps2, boolean nullLess)
          順序付けのために null 値の比較機能を追加して、反復子順に要素を比較します。
static int compare(java.util.Collection comps, java.util.Collection comps2, java.util.Comparator comparator, boolean nullLess)
          順序付けのために null 値の比較機能を追加して、反復子順に要素を比較します。
static int compare(java.lang.Comparable comp, java.lang.Comparable comp2, boolean nullLess)
          順序付けのために null 値の比較機能を追加して、2 つの引数を比較します。
static int compare(java.lang.Object o, java.lang.Object o2, java.util.Comparator comp, boolean nullLess)
          順序付けのために null 値の比較機能を追加して、2 つの引数を比較します。
static java.util.Comparator nullComparator(boolean nullLess)
          null 値の比較を追加機能とする、順序付け比較関数を返却します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

ComparatorUtils

public ComparatorUtils()
メソッドの詳細

nullComparator

public static java.util.Comparator nullComparator(boolean nullLess)
null 値の比較を追加機能とする、順序付け比較関数を返却します。
返却される比較関数は、compare(Comparable, Comparable, boolean) を呼び出します。

パラメータ:
nullLess - null を null 以外より小さいと評価する場合は true
戻り値:
null 値の比較を追加機能とする、順序付け比較関数

compare

public static int compare(java.lang.Comparable comp,
                          java.lang.Comparable comp2,
                          boolean nullLess)
順序付けのために null 値の比較機能を追加して、2 つの引数を比較します。
双方の引数が null の場合は 0 を返却します。
引数の片方のみが null の場合は、引数 nullLess により結果が変わります。
引数 nullLess が false の場合は、null を常に大きいと見なします。
逆に nullLess が true の場合は、null を常に小さいと見なします。

パラメータ:
comp - 評価基の値
comp2 - 評価先の値
nullLess - null を null 以外より小さいと評価する場合は true
戻り値:
第1引数と第2引数が同値の場合は 0、第1引数が大きい場合は 1、第1引数が小さい場合は -1

compare

public static int compare(java.lang.Object o,
                          java.lang.Object o2,
                          java.util.Comparator comp,
                          boolean nullLess)
順序付けのために null 値の比較機能を追加して、2 つの引数を比較します。
双方の引数が null の場合は 0 を返却します。
引数の片方のみが null の場合は、引数 nullLess により結果が変わります。
引数 nullLess が false の場合は、null を常に大きいと見なします。
逆に nullLess が true の場合は、null を常に小さいと見なします。

パラメータ:
o - 評価基の値
o2 - 評価先の値
comp - 順序付け比較関数
nullLess - null を null 以外より小さいと評価する場合は true
戻り値:
第1引数と第2引数が同値の場合は 0、第1引数が大きい場合は 1、第1引数が小さい場合は -1

compare

public static int compare(java.util.Collection comps,
                          java.util.Collection comps2,
                          boolean nullLess)
順序付けのために null 値の比較機能を追加して、反復子順に要素を比較します。
要素は全て Comparable 型の必要が有ります。
引数の片方のみが null の場合は、引数 nullLess により結果が変わります。
引数 nullLess が false の場合は、null を常に大きいと見なします。
逆に nullLess が true の場合は、null を常に小さいと見なします。

以外の場合には、反復子の先頭から比較し、結果が 0 以外の場合にその結果を返却します。
要素数の小さい方の、末尾まで全ての比較が 0 の場合は、要素数で比較します。
つまり要素数が同数の場合は 0、第1引数が大きい場合は 1、第1引数が小さい場合は -1、とします。
また各要素は compare(Comparable, Comparable, boolean) の基準で比較します。

パラメータ:
comps - 評価基の配列
comps2 - 評価先の配列
nullLess - null を null 以外より小さいと評価する場合は true
戻り値:
第1引数と第2引数が同値の場合は 0、第1引数が大きい場合は 1、第1引数が小さい場合は -1

compare

public static int compare(java.util.Collection comps,
                          java.util.Collection comps2,
                          java.util.Comparator comparator,
                          boolean nullLess)
順序付けのために null 値の比較機能を追加して、反復子順に要素を比較します。
引数の片方のみが null の場合は、引数 nullLess により結果が変わります。
引数 nullLess が false の場合は、null を常に大きいと見なします。
逆に nullLess が true の場合は、null を常に小さいと見なします。

以外の場合には、反復子の先頭から比較し、結果が 0 以外の場合にその結果を返却します。
要素数の小さい方の、末尾まで全ての比較が 0 の場合は、要素数で比較します。
つまり要素数が同数の場合は 0、第1引数が大きい場合は 1、第1引数が小さい場合は -1、とします。
また各要素は compare(Object, Object, Comparator, boolean) の基準で比較します。

パラメータ:
comps - 評価基の配列
comps2 - 評価先の配列
comparator - 順序付け比較関数
nullLess - null を null 以外より小さいと評価する場合は true
戻り値:
第1引数と第2引数が同値の場合は 0、第1引数が大きい場合は 1、第1引数が小さい場合は -1