Package com.helger.commons.compare

Class CompareHelper

java.lang.Object
com.helger.commons.compare.CompareHelper
@Immutable public final class CompareHelper extends Object
A small helper class that provides comparison methods that are null safe. Also provides secure ways to compare double and float values.
Author:
Philip Helger

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final boolean
    DEFAULT_NULL_VALUES_COME_FIRST
    By default null values come first

  • Method Summary

    Modifier and Type
    Method
    Description
    static int
    compare(byte n1, byte n2)
    Special version for byte
    static int
    compare(char n1, char n2)
    Special version for byte
    static int
    compare(double d1, double d2)
    Special version for doubles
    static int
    compare(float f1, float f2)
    Special version for floats
    static int
    compare(int n1, int n2)
    Special version for int
    static int
    compare(long n1, long n2)
    Special version for long
    static int
    compare(short n1, short n2)
    Special version for short
    static <DATATYPE extends Comparable<? super DATATYPE>>
    int
    compare(DATATYPE aObj1, DATATYPE aObj2)
    Compare the passed items and handle null values correctly.
    static <DATATYPE extends Comparable<? super DATATYPE>>
    int
    compare(DATATYPE aObj1, DATATYPE aObj2, boolean bNullValuesComeFirst)
    Compare the passed items and handle null values correctly.
    static <DATATYPE> int
    compare(DATATYPE aObj1, DATATYPE aObj2, Comparator<? super DATATYPE> aComp)
    Compare the passed items and handle null values correctly.
    static <DATATYPE> int
    compare(DATATYPE aObj1, DATATYPE aObj2, Comparator<? super DATATYPE> aComp, boolean bNullValuesComeFirst)
    Compare the passed items and handle null values correctly.
    static int
    compare(String sStr1, String sStr2, Collator aCollator)
     
    static int
    compare(String sStr1, String sStr2, Collator aCollator, boolean bNullValuesComeFirst)
     
    static int
    compare(String sStr1, String sStr2, Locale aSortLocale)
     
    static int
    compare(String sStr1, String sStr2, Locale aSortLocale, boolean bNullValuesComeFirst)
     
    static int
    compareFalseBeforeTrue(boolean b1, boolean b2)
    Special version for boolean, true before false
    static int
    compareIgnoreCase(String sStr1, String sStr2)
     
    static int
    compareIgnoreCase(String sStr1, String sStr2, boolean bNullValuesComeFirst)
     
    static int
    compareTrueBeforeFalse(boolean b1, boolean b2)
    Special version for boolean, true before false

    Methods inherited from class java.lang.Object

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

  • Field Details

    • DEFAULT_NULL_VALUES_COME_FIRST

      public static final boolean DEFAULT_NULL_VALUES_COME_FIRST
      By default null values come first
      See Also:

  • Method Details

    • compareTrueBeforeFalse

      public static int compareTrueBeforeFalse(boolean b1, boolean b2)
      Special version for boolean, true before false
      Parameters:
      b1 - First value
      b2 - Second value
      Returns:
      -1, 0 or + 1

    • compareFalseBeforeTrue

      public static int compareFalseBeforeTrue(boolean b1, boolean b2)
      Special version for boolean, true before false
      Parameters:
      b1 - First value
      b2 - Second value
      Returns:
      -1, 0 or + 1

    • compare

      public static int compare(byte n1, byte n2)
      Special version for byte
      Parameters:
      n1 - First value
      n2 - Second value
      Returns:
      value <0, 0 or >0.

    • compare

      public static int compare(char n1, char n2)
      Special version for byte
      Parameters:
      n1 - First value
      n2 - Second value
      Returns:
      value <0, 0 or >0.

    • compare

      public static int compare(double d1, double d2)
      Special version for doubles
      Parameters:
      d1 - First value
      d2 - Second value
      Returns:
      value <0, 0 or >0.

    • compare

      public static int compare(float f1, float f2)
      Special version for floats
      Parameters:
      f1 - First value
      f2 - Second value
      Returns:
      value <0, 0 or >0.

    • compare

      public static int compare(int n1, int n2)
      Special version for int
      Parameters:
      n1 - First value
      n2 - Second value
      Returns:
      value <0, 0 or >0.

    • compare

      public static int compare(long n1, long n2)
      Special version for long
      Parameters:
      n1 - First value
      n2 - Second value
      Returns:
      value <0, 0 or >0.

    • compare

      public static int compare(short n1, short n2)
      Special version for short
      Parameters:
      n1 - First value
      n2 - Second value
      Returns:
      value <0, 0 or >0.

    • compare

      public static <DATATYPE extends Comparable<? super DATATYPE>> int compare(@Nullable DATATYPE aObj1, @Nullable DATATYPE aObj2)
      Compare the passed items and handle null values correctly. A null value is always smaller than a non-null value.
      Type Parameters:
      DATATYPE - Any comparable object to be used. Both need to be of the same type.
      Parameters:
      aObj1 - First object to compare. May be null.
      aObj2 - Second object to compare. May be null.
      Returns:
      0 if they are equal (or both null), -1 or +1.

    • compare

      public static <DATATYPE extends Comparable<? super DATATYPE>> int compare(@Nullable DATATYPE aObj1, @Nullable DATATYPE aObj2, boolean bNullValuesComeFirst)
      Compare the passed items and handle null values correctly. A null value is always smaller than a non-null value.
      Type Parameters:
      DATATYPE - Any comparable object to be used. Both need to be of the same type.
      Parameters:
      aObj1 - First object to compare. May be null.
      aObj2 - Second object to compare. May be null.
      bNullValuesComeFirst - if true null values are ordered before non-null values
      Returns:
      0 if they are equal (or both null), -1 or +1.

    • compare

      public static <DATATYPE> int compare(@Nullable DATATYPE aObj1, @Nullable DATATYPE aObj2, @Nonnull Comparator<? super DATATYPE> aComp)
      Compare the passed items and handle null values correctly. A null value is always smaller than a non-null value.
      Type Parameters:
      DATATYPE - Any object to be used. Both need to be of the same type.
      Parameters:
      aObj1 - First object to compare. May be null.
      aObj2 - Second object to compare. May be null.
      aComp - The comparator to be used if both parameters are not null. The comparator itself may not be null.
      Returns:
      0 if they are equal (or both null), -1 or +1.

    • compare

      public static <DATATYPE> int compare(@Nullable DATATYPE aObj1, @Nullable DATATYPE aObj2, @Nonnull Comparator<? super DATATYPE> aComp, boolean bNullValuesComeFirst)
      Compare the passed items and handle null values correctly. A null value is always smaller than a non-null value.
      Type Parameters:
      DATATYPE - Any object to be used. Both need to be of the same type.
      Parameters:
      aObj1 - First object to compare. May be null.
      aObj2 - Second object to compare. May be null.
      aComp - The comparator to be used if both parameters are not null. The comparator itself may not be null.
      bNullValuesComeFirst - if true null values are ordered before non-null values
      Returns:
      0 if they are equal (or both null), -1 or +1.

    • compare

      public static int compare(@Nullable String sStr1, @Nullable String sStr2, @Nonnull Locale aSortLocale)

    • compare

      public static int compare(@Nullable String sStr1, @Nullable String sStr2, @Nonnull Locale aSortLocale, boolean bNullValuesComeFirst)

    • compare

      public static int compare(@Nullable String sStr1, @Nullable String sStr2, @Nonnull Collator aCollator)

    • compare

      public static int compare(@Nullable String sStr1, @Nullable String sStr2, @Nonnull Collator aCollator, boolean bNullValuesComeFirst)

    • compareIgnoreCase

      public static int compareIgnoreCase(@Nullable String sStr1, @Nullable String sStr2)

    • compareIgnoreCase

      public static int compareIgnoreCase(@Nullable String sStr1, @Nullable String sStr2, boolean bNullValuesComeFirst)