Package it.unimi.dsi.fastutil.doubles

Interface DoubleComparator

All Superinterfaces:

Comparator<Double>

All Known Implementing Classes:

AbstractDoubleComparator

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 Comparator<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	Description
int	compare(double k1, double k2)	Compares its two primitive-type arguments for order.
default int	compare(Double ok1, Double ok2)	Deprecated. Please use the corresponding type-specific method instead.
static <U extends 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 Comparable<? super U>> DoubleComparator	comparing(Double2ObjectFunction<? extends U> keyExtractor, 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 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.
default Comparator<Double>	thenComparing(Comparator<? super Double> second)

Methods inherited from interface java.util.Comparator

equals, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Method Details

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 Comparator<Double>

compare

@Deprecated
default int compare(Double ok1,
 Double ok2)

Deprecated.

Please use the corresponding type-specific method instead.

Specified by:

compare in interface Comparator<Double>

Implementation Specification:

This implementation delegates to the corresponding type-specific method.

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 Comparator<Double> thenComparing(Comparator<? super Double> second)

Specified by:

thenComparing in interface Comparator<Double>

comparing

static <U extends 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:

NullPointerException - if keyExtractor is null

comparing

static <U extends Comparable<? super U>>
DoubleComparator comparing(Double2ObjectFunction<? extends U> keyExtractor,
 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:

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:

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:

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:

NullPointerException - if keyExtractor is null