it.unimi.dsi.fastutil.shorts

Interface ShortComparator

All Superinterfaces:

java.util.Comparator<java.lang.Short>

All Known Implementing Classes:

ShortComparators.NaturalImplicitComparator, ShortComparators.OppositeComparator, ShortComparators.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 ShortComparator
extends java.util.Comparator<java.lang.Short>

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(short k1, short k2) Compares its two primitive-type arguments for order.
default int	compare(java.lang.Short ok1, java.lang.Short ok2) Deprecated. Please use the corresponding type-specific method instead.
static <U extends java.lang.Comparable<? super U>> ShortComparator	comparing(Short2ObjectFunction<? 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>> ShortComparator	comparing(Short2ObjectFunction<? 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 ShortComparator	comparingDouble(Short2DoubleFunction 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 ShortComparator	comparingInt(Short2IntFunction 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 ShortComparator	comparingLong(Short2LongFunction 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 ShortComparator	reversed()
default java.util.Comparator<java.lang.Short>	thenComparing(java.util.Comparator<? super java.lang.Short> second)
default ShortComparator	thenComparing(ShortComparator 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(short k1,
            short 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 ShortComparator reversed()

Specified by:

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

compare

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

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

Specified by:

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

thenComparing

default ShortComparator thenComparing(ShortComparator 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.Short> thenComparing(java.util.Comparator<? super java.lang.Short> second)

Specified by:

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

comparing

static <U extends java.lang.Comparable<? super U>> ShortComparator comparing(Short2ObjectFunction<? 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>> ShortComparator comparing(Short2ObjectFunction<? 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 ShortComparator comparingInt(Short2IntFunction 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 ShortComparator comparingLong(Short2LongFunction 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 ShortComparator comparingDouble(Short2DoubleFunction 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