com.gargoylesoftware.base.collections

Class StringComparator

java.lang.Object

com.gargoylesoftware.base.collections.StringComparator

All Implemented Interfaces:

Comparator

public class StringComparator
extends Object
implements Comparator

A concrete implementation of Comparator that compares two strings. If a locale is specified then the comparison will be performed using the locale specific collating sequences. If the locale is not specified then a binary comparison will be performed.

Version:

$Revision: 1.3 $

Author:

Mike Bowler

Constructor Summary

Constructors

Constructor and Description
StringComparator(Locale locale) Create a locale specific comparator.
StringComparator(Locale locale, int collatorStrength, boolean isAscending) Create a locale specific comparator.

Method Summary

Modifier and Type	Method and Description
int	compare(Object object1, Object object2) Compare the two strings.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Comparator

comparing, comparing, comparingDouble, comparingInt, comparingLong, equals, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Constructor Detail

StringComparator

public StringComparator(Locale locale,
                        int collatorStrength,
                        boolean isAscending)

Create a locale specific comparator.

Parameters:

locale - The locale to be used when determining sorting order. If locale is null then a binary comparison is performed.

collatorStrength - The strength value to be used by the Collator. If locale is null then this value is ignored.

isAscending - True if we are sorting in ascending order, false otherwise.

StringComparator

public StringComparator(Locale locale)

Create a locale specific comparator.

Parameters:

locale - The locale to be used when determining sorting order. If locale is null then a binary comparison is performed.

Method Detail

compare

public int compare(Object object1,
                   Object object2)

Compare the two strings.

Specified by:

compare in interface Comparator

Parameters:

object1 - The first string.

object2 - The second string.

Returns:

a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second.