com.gargoylesoftware.base.collections
Class StringComparator

java.lang.Object
  extended bycom.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.4 $
Author:
Mike Bowler

Constructor Summary
StringComparator(Locale locale)
          Create a locale specific comparator.
StringComparator(Locale locale, int collatorStrength, boolean isAscending)
          Create a locale specific comparator.
 
Method Summary
 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
equals
 

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.


Copyright © 1998-2005 Gargoyle Software Inc.. All Rights Reserved.