Modifier and Type	Class and Description
pack-priv static enum	Comparators.NaturalOrderComparator Compares `Comparable` objects in natural order.
pack-priv static class	Comparators.NullComparator<T> Null-friendly comparators

Access	Constructor and Description
private	Comparators()

Comparators	back to summary
private Comparators()

java.util back to summary

pack-priv final Enum Comparators.NaturalOrderComparator

Class Inheritance

extends Enum<Comparators.NaturalOrderComparator>
implements Comparator<Comparable<Object>>

java.lang.Object
java.lang.Enum
java.util.Comparators.NaturalOrderComparator

All Implemented Interfaces

java.util.Comparator

Compares Comparable objects in natural order.

See Also: Comparable

Field Summary

Modifier and Type	Field and Description
public static final Comparators.NaturalOrderComparator	INSTANCE

Constructor Summary

Access	Constructor and Description
private	NaturalOrderComparator()

Method Summary

Modifier and Type	Method and Description
public int	compare(Comparable<Object> the first object to be compared. c1, Comparable<Object> the second object to be compared. c2) Implements java.util.Comparator.compare. Compares its two arguments for order.
public Comparator<Comparable<Object>>	reversed() Overrides default java.util.Comparator.reversed. Returns a comparator that imposes the reverse ordering of this comparator.
public static Comparators.NaturalOrderComparator	valueOf(String name)
public static Comparators.NaturalOrderComparator[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

INSTANCE	back to summary
public static final Comparators.NaturalOrderComparator INSTANCE

Constructor Detail

NaturalOrderComparator	back to summary
private NaturalOrderComparator()

Method Detail

compare back to summary

compare	back to summary
public int compare(Comparable<Object> c1, Comparable<Object> c2) Implements java.util.Comparator.compare. Doc from java.util.Comparator.compare. Compares its two arguments for order. Returns a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second. The implementor must ensure that `signum(compare(x, y)) == -signum(compare(y, x))` for all `x` and `y`. (This implies that `compare(x, y)` must throw an exception if and only if `compare(y, x)` throws an exception.) The implementor must also ensure that the relation is transitive: `((compare(x, y)>0) && (compare(y, z)>0))` implies `compare(x, z)>0`. Finally, the implementor must ensure that `compare(x, y)==0` implies that `signum(compare(x, z))==signum(compare(y, z))` for all `z`. Parameters c1:Comparable<Object> the first object to be compared. c2:Comparable<Object> the second object to be compared. Returns:int a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second. Annotations @Override

public int compare(Comparable<Object> c1, Comparable<Object> c2)

Implements java.util.Comparator.compare.

Doc from java.util.Comparator.compare.

Compares its two arguments for order. Returns a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second.

The implementor must ensure that signum(compare(x, y)) == -signum(compare(y, x)) for all x and y. (This implies that compare(x, y) must throw an exception if and only if compare(y, x) throws an exception.)

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

Finally, the implementor must ensure that compare(x, y)==0 implies that signum(compare(x, z))==signum(compare(y, z)) for all z.

Parameters

c1:Comparable<Object>: the first object to be compared.
c2:Comparable<Object>: the second object to be compared.

Returns:int

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

Annotations

@Override

reversed	back to summary
public Comparator<Comparable<Object>> reversed() Overrides default java.util.Comparator.reversed. Doc from java.util.Comparator.reversed. Returns a comparator that imposes the reverse ordering of this comparator. Returns:Comparator<Comparable<Object>> a comparator that imposes the reverse ordering of this comparator. Annotations @Override

reversed

back to summary

public Comparator<Comparable<Object>> reversed()

Overrides default java.util.Comparator.reversed.

Doc from java.util.Comparator.reversed.

Returns a comparator that imposes the reverse ordering of this comparator.

Returns:Comparator<Comparable<Object>>

a comparator that imposes the reverse ordering of this comparator.

Annotations

@Override

valueOf	back to summary
public static Comparators.NaturalOrderComparator valueOf(String name)

values	back to summary
public static Comparators.NaturalOrderComparator[] values()

java.util back to summary

pack-priv final Class Comparators.NullComparator<T>

Class Inheritance

extends Object
implements Comparator<T>, Serializable

java.lang.Object
java.util.Comparators.NullComparator

All Implemented Interfaces

java.io.Serializable, java.util.Comparator

Null-friendly comparators

Field Summary

Modifier and Type	Field and Description
private final boolean	nullFirst
private final Comparator<T>	real
private static final long	serialVersionUID

Constructor Summary

Access	Constructor and Description
pack-priv	NullComparator(boolean nullFirst, Comparator<? super T> real)

Method Summary

Modifier and Type	Method and Description
public int	compare(T the first object to be compared. a, T the second object to be compared. b) Implements java.util.Comparator.compare. Compares its two arguments for order.
public Comparator<T>	reversed() Overrides default java.util.Comparator.reversed. Returns a comparator that imposes the reverse ordering of this comparator.
public Comparator<T>	thenComparing(Comparator<? super T> the other comparator to be used when this comparator compares two objects that are equal. other) Overrides default java.util.Comparator.thenComparing. Returns a lexicographic-order comparator with another comparator.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

nullFirst	back to summary
private final boolean nullFirst

real	back to summary
private final Comparator<T> real Annotations @SuppressWarnings:serial

serialVersionUID	back to summary
private static final long serialVersionUID Annotations @Serial

Constructor Detail

NullComparator	back to summary
pack-priv NullComparator(boolean nullFirst, Comparator<? super T> real) Annotations @SuppressWarnings:unchecked

Method Detail

compare back to summary

compare	back to summary
public int compare(T a, T b) Implements java.util.Comparator.compare. Doc from java.util.Comparator.compare. Compares its two arguments for order. Returns a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second. The implementor must ensure that `signum(compare(x, y)) == -signum(compare(y, x))` for all `x` and `y`. (This implies that `compare(x, y)` must throw an exception if and only if `compare(y, x)` throws an exception.) The implementor must also ensure that the relation is transitive: `((compare(x, y)>0) && (compare(y, z)>0))` implies `compare(x, z)>0`. Finally, the implementor must ensure that `compare(x, y)==0` implies that `signum(compare(x, z))==signum(compare(y, z))` for all `z`. Parameters a:T the first object to be compared. b:T the second object to be compared. Returns:int a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second. Annotations @Override

public int compare(T a, T b)

Implements java.util.Comparator.compare.

Doc from java.util.Comparator.compare.

Compares its two arguments for order. Returns a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second.

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

Finally, the implementor must ensure that compare(x, y)==0 implies that signum(compare(x, z))==signum(compare(y, z)) for all z.

Parameters

a:T: the first object to be compared.
b:T: the second object to be compared.

Returns:int

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

Annotations

@Override

reversed	back to summary
public Comparator<T> reversed() Overrides default java.util.Comparator.reversed. Doc from java.util.Comparator.reversed. Returns a comparator that imposes the reverse ordering of this comparator. Returns:Comparator<T> a comparator that imposes the reverse ordering of this comparator. Annotations @Override

reversed

back to summary

public Comparator<T> reversed()

Overrides default java.util.Comparator.reversed.

Doc from java.util.Comparator.reversed.

Returns a comparator that imposes the reverse ordering of this comparator.

Returns:Comparator<T>

a comparator that imposes the reverse ordering of this comparator.

Annotations

@Override

thenComparing back to summary

thenComparing	back to summary
public Comparator<T> thenComparing(Comparator<? super T> other) Overrides default java.util.Comparator.thenComparing. Doc from java.util.Comparator.thenComparing. Returns a lexicographic-order comparator with another comparator. If this `Comparator` considers two elements equal, i.e. `compare(a, b) == 0`, `other` is used to determine the order. The returned comparator is serializable if the specified comparator is also serializable. Parameters other:Comparator<? super T> the other comparator to be used when this comparator compares two objects that are equal. Returns:Comparator<T> a lexicographic-order comparator composed of this and then the other comparator Annotations @Override

public Comparator<T> thenComparing(Comparator<? super T> other)

Overrides default java.util.Comparator.thenComparing.

Doc from java.util.Comparator.thenComparing.

Returns a lexicographic-order comparator with another comparator. If this Comparator considers two elements equal, i.e. compare(a, b) == 0, other is used to determine the order.

The returned comparator is serializable if the specified comparator is also serializable.

Parameters

other:Comparator<? super T>: the other comparator to be used when this comparator compares two objects that are equal.

Returns:Comparator<T>

a lexicographic-order comparator composed of this and then the other comparator

Annotations

@Override

pack-priv Class Comparators

Nested and Inner Type Summary

Constructor Summary

Method Summary

Constructor Detail

pack-priv final Enum Comparators.NaturalOrderComparator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class Comparators.NullComparator<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail