All Packages  Class Hierarchy  This Package  Previous  Next  Index  

Interface java.lang.Comparable

public interface Comparable

Arrays of Objects that implement this interface can be sorted automatically by List.sort. Objects of these classes can also be used as keys in TreeTables without the need to specify a Comparator.

Classes that implement this interface include String, Byte, Character, Short, Integer, Long, Float, Double, BigInteger, BigDecimal, File, URL, Date.

See Also:

Comparator, sort, TreeTable

compareTo(Object)

Compares this Object with the specified Object for order.

public abstract int compareTo(Object o)

Compares this Object with the specified Object for order. Returns a negative integer, zero, or a positive integer as this Object is less than, equal to, or greater than the given Object.

The implementor must ensure sgn(x.compareTo(y)) == -sgn(y.compareTo(x)) for all x and y. (This implies that x.compareTo(y) must throw an exception iff y.compareTo(x) throws an exception.)

The implementor must also ensure that the relation is transitive: (x.compareTo(y)>0 && y.compareTo(z)>0) implies x.compareTo(z)>0.

The implementer must also ensure that x.equals(y) implies that x.compareTo(y)==0. Note that the converse is not necessarily true (e.g., BigDecimal).

Finally, the implementer must ensure that x.compareTo(y)==0 implies that sgn(x.compareTo(z)) == sgn(y.compareTo(z)), for all z.

Parameters:

o - the Object to be compared.

Returns:

a negative integer, zero, or a positive integer as this Object is less than, equal to, or greater than the given Object.

Throws: ClassCastException

the specified Object's type prevents it from being compared to this Object.

All Packages  Class Hierarchy  This Package  Previous  Next  Index