net.mintern.primitive

Class Primitive

java.lang.Object

net.mintern.primitive.Primitive

public final class Primitive
extends Object

A utility class that provides comparator-based sorting methods for all primitive arrays. It also provides non-comparator sort methods for boolean arrays since Arrays does not.

Method Summary

Modifier and Type	Method and Description
static void	sort(boolean[] a) Sorts the given array so that all the false values are at the beginning.
static void	sort(boolean[] a, BooleanComparator c) Sorts the given array by the given comparator.
static void	sort(boolean[] a, int fromIndex, int toIndex) Sorts the indicated portion of the given array so that all the false values are at the beginning.
static void	sort(boolean[] a, int fromIndex, int toIndex, BooleanComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(byte[] a, ByteComparator c) Sorts the given array by the given comparator.
static void	sort(byte[] a, int fromIndex, int toIndex, ByteComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(char[] a, CharComparator c) Sorts the given array by the given comparator.
static void	sort(char[] a, int fromIndex, int toIndex, CharComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(double[] a, DoubleComparator c) Sorts the given array by the given comparator.
static void	sort(double[] a, int fromIndex, int toIndex, DoubleComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(float[] a, FloatComparator c) Sorts the given array by the given comparator.
static void	sort(float[] a, int fromIndex, int toIndex, FloatComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(int[] a, IntComparator c) Sorts the given array by the given comparator.
static void	sort(int[] a, int fromIndex, int toIndex, IntComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(long[] a, int fromIndex, int toIndex, LongComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(long[] a, LongComparator c) Sorts the given array by the given comparator.
static void	sort(short[] a, int fromIndex, int toIndex, ShortComparator c) Sorts the indicated portion of the given array by the given comparator.
static void	sort(short[] a, ShortComparator c) Sorts the given array by the given comparator.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

sort

public static void sort(boolean[] a)

Sorts the given array so that all the false values are at the beginning.

Parameters:

a - the array to sort

Throws:

NullPointerException - if a == null

sort

public static void sort(boolean[] a,
                        int fromIndex,
                        int toIndex)

Sorts the indicated portion of the given array so that all the false values are at the beginning.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex

sort

public static void sort(boolean[] a,
                        BooleanComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the BooleanComparator contract

sort

public static void sort(boolean[] a,
                        int fromIndex,
                        int toIndex,
                        BooleanComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the BooleanComparator contract

sort

public static void sort(byte[] a,
                        ByteComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the ByteComparator contract

sort

public static void sort(byte[] a,
                        int fromIndex,
                        int toIndex,
                        ByteComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the ByteComparator contract

sort

public static void sort(char[] a,
                        CharComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the CharComparator contract

sort

public static void sort(char[] a,
                        int fromIndex,
                        int toIndex,
                        CharComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the CharComparator contract

sort

public static void sort(double[] a,
                        DoubleComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the DoubleComparator contract

sort

public static void sort(double[] a,
                        int fromIndex,
                        int toIndex,
                        DoubleComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the DoubleComparator contract

sort

public static void sort(float[] a,
                        FloatComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the FloatComparator contract

sort

public static void sort(float[] a,
                        int fromIndex,
                        int toIndex,
                        FloatComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the FloatComparator contract

sort

public static void sort(int[] a,
                        IntComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the IntComparator contract

sort

public static void sort(int[] a,
                        int fromIndex,
                        int toIndex,
                        IntComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the IntComparator contract

sort

public static void sort(long[] a,
                        LongComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the LongComparator contract

sort

public static void sort(long[] a,
                        int fromIndex,
                        int toIndex,
                        LongComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the LongComparator contract

sort

public static void sort(short[] a,
                        ShortComparator c)

Sorts the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

IllegalArgumentException - if sorting finds that c violates the ShortComparator contract

sort

public static void sort(short[] a,
                        int fromIndex,
                        int toIndex,
                        ShortComparator c)

Sorts the indicated portion of the given array by the given comparator. The sorting algorithm used is a stable sort, so two items that compare to 0 will be kept in the same order when the sort is complete.

Parameters:

a - the array to sort

fromIndex - the index (inclusive) marking the beginning of the array portion

toIndex - the index (exclusive) marking the end of the array portion

c - the comparator to use for sorting the array, or null for natural ordering

Throws:

NullPointerException - if a == null

ArrayIndexOutOfBoundsException - if fromIndex < 0 or toIndex > a.length

IllegalArgumentException - if fromIndex > toIndex or sorting finds that c violates the ShortComparator contract