it.unimi.dsi.fastutil.doubles

Interface DoubleComparator

All Superinterfaces:

java.util.Comparator<java.lang.Double>

All Known Implementing Classes:

DoubleComparators.NaturalImplicitComparator, DoubleComparators.OppositeComparator, DoubleComparators.OppositeImplicitComparator

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface DoubleComparator
extends java.util.Comparator<java.lang.Double>

A type-specific Comparator; provides methods to compare two primitive types both as objects and as primitive types.

Note that fastutil provides a corresponding abstract class that can be used to implement this interface just by specifying the type-specific comparator.

See Also:

Comparator

Method Summary

Modifier and Type	Method and Description
int	compare(double k1, double k2) Compares its two primitive-type arguments for order.
default int	compare(java.lang.Double ok1, java.lang.Double ok2) Deprecated. Please use the corresponding type-specific method instead.
static <U extends java.lang.Comparable<? super U>> DoubleComparator	comparing(Double2ObjectFunction<? extends U> keyExtractor) Accepts a function that extracts a Comparable sort key from a primitive key, and returns a comparator that compares by that sort key.
static <U extends java.lang.Comparable<? super U>> DoubleComparator	comparing(Double2ObjectFunction<? extends U> keyExtractor, java.util.Comparator<? super U> keyComparator) Accepts a function that extracts a sort key from a primitive key, and returns a comparator that compares by that sort key using the specified Comparator.
static DoubleComparator	comparingDouble(Double2DoubleFunction keyExtractor) Accepts a function that extracts an double sort key from a primitive key, and returns a comparator that compares by that sort key.
static DoubleComparator	comparingInt(Double2IntFunction keyExtractor) Accepts a function that extracts an int sort key from a primitive key, and returns a comparator that compares by that sort key.
static DoubleComparator	comparingLong(Double2LongFunction keyExtractor) Accepts a function that extracts an long sort key from a primitive key, and returns a comparator that compares by that sort key.
default DoubleComparator	reversed()
default java.util.Comparator<java.lang.Double>	thenComparing(java.util.Comparator<? super java.lang.Double> second)
default DoubleComparator	thenComparing(DoubleComparator second) Return a new comparator that first uses this comparator, then uses the second comparator if this comparator compared the two elements as equal.

Methods inherited from interface java.util.Comparator

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

Method Detail

compare

int compare(double k1,
            double k2)

Compares its two primitive-type 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.

Returns:

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

See Also:

Comparator

reversed

default DoubleComparator reversed()

Specified by:

reversed in interface java.util.Comparator<java.lang.Double>

compare

@Deprecated
default int compare(java.lang.Double ok1,
                                java.lang.Double ok2)

Deprecated. Please use the corresponding type-specific method instead.

Specified by:

compare in interface java.util.Comparator<java.lang.Double>

thenComparing

default DoubleComparator thenComparing(DoubleComparator second)

Return a new comparator that first uses this comparator, then uses the second comparator if this comparator compared the two elements as equal.

See Also:

Comparator.thenComparing(Comparator)

thenComparing

default java.util.Comparator<java.lang.Double> thenComparing(java.util.Comparator<? super java.lang.Double> second)

Specified by:

thenComparing in interface java.util.Comparator<java.lang.Double>

comparing

static <U extends java.lang.Comparable<? super U>> DoubleComparator comparing(Double2ObjectFunction<? extends U> keyExtractor)

Accepts a function that extracts a Comparable sort key from a primitive key, and returns a comparator that compares by that sort key.

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

Parameters:

keyExtractor - the function used to extract the Comparable sort key

Returns:

a comparator that compares by an extracted key

Throws:

java.lang.NullPointerException - if keyExtractor is null

comparing

static <U extends java.lang.Comparable<? super U>> DoubleComparator comparing(Double2ObjectFunction<? extends U> keyExtractor,
                                                                              java.util.Comparator<? super U> keyComparator)

Accepts a function that extracts a sort key from a primitive key, and returns a comparator that compares by that sort key using the specified Comparator.

The returned comparator is serializable if the specified function and comparator are both serializable.

Parameters:

keyExtractor - the function used to extract the sort key

keyComparator - the Comparator used to compare the sort key

Returns:

a comparator that compares by an extracted key using the specified Comparator

Throws:

java.lang.NullPointerException - if keyExtractor or keyComparator are null

comparingInt

static DoubleComparator comparingInt(Double2IntFunction keyExtractor)

Accepts a function that extracts an int sort key from a primitive key, and returns a comparator that compares by that sort key.

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

Parameters:

keyExtractor - the function used to extract the integer sort key

Returns:

a comparator that compares by an extracted key

Throws:

java.lang.NullPointerException - if keyExtractor is null

comparingLong

static DoubleComparator comparingLong(Double2LongFunction keyExtractor)

Accepts a function that extracts an long sort key from a primitive key, and returns a comparator that compares by that sort key.

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

Parameters:

keyExtractor - the function used to extract the long sort key

Returns:

a comparator that compares by an extracted key

Throws:

java.lang.NullPointerException - if keyExtractor is null

comparingDouble

static DoubleComparator comparingDouble(Double2DoubleFunction keyExtractor)

Accepts a function that extracts an double sort key from a primitive key, and returns a comparator that compares by that sort key.

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

Parameters:

keyExtractor - the function used to extract the double sort key

Returns:

a comparator that compares by an extracted key

Throws:

java.lang.NullPointerException - if keyExtractor is null