Package manifold.ext.rt.extensions.manifold.rt.api.Array

Class ManArrayExt

java.lang.Object

manifold.ext.rt.extensions.manifold.rt.api.Array.ManArrayExt

public class ManArrayExt
extends Object

Adds convenience methods to Java's array type. Uses @Self to enforce type-safety with both the array type and the array component type.

Constructor Summary

Constructors

Constructor	Description
ManArrayExt()

Method Summary

Modifier and Type	Method	Description
static int	binarySearch(Object array, int from, int to, Object key)
static int	binarySearch(Object array, int from, int to, Object key, Comparator<? super Object> comparator)
static int	binarySearch(Object array, Object key)
static int	binarySearch(Object array, Object key, Comparator<? super Object> comparator)
static Object	copy(Object array)
static Object	copy(Object array, int newLength)	Copies this array's elements into a new array of the specified newLength.
static Object	copyRange(Object array, int from, int to)	Copies a range of elements from this array to a newly allocated array.
static Object	copyRangeTo(Object array, int from, int to, Object target, int targetIndex)	Copies a range of elements from this array to the target array.
static Object	copyTo(Object array, Object to)	Copies the elements of this array to a specified array, truncating or padding with nulls as needed.
static boolean	equals(Object array, Object that)
static Object	first(Object array)
static void	forEach(Object array, IndexedConsumer<? super Object> action)
static int	hashCode(Object array)
static boolean	isEmpty(Object array)
static boolean	isNullOrEmpty(Object array)
static Object	last(Object array)
static Spliterator<Object>	spliterator(Object array)
static Stream<Object>	stream(Object array)	Returns a sequential Stream with this array as its source.
static List<Object>	toList(Object array)	Returns a fixed-size list backed by the specified array.
static String	toString(Object array)

Methods inherited from class java.lang.Object

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

Constructor Detail

ManArrayExt

public ManArrayExt()

Method Detail

toList

public static List<Object> toList(Object array)

Returns a fixed-size list backed by the specified array. (Changes to the returned list "write through" to the array.) This method acts as bridge between array-based and collection-based APIs, in combination with Collection.toArray(). The returned list is serializable and implements RandomAccess.

Returns:

a list view of the specified array

isEmpty

public static boolean isEmpty(Object array)

isNullOrEmpty

public static boolean isNullOrEmpty(Object array)

first

public static Object first(Object array)

last

public static Object last(Object array)

copy

public static Object copy(Object array)

copy

public static Object copy(Object array,
                          int newLength)

Copies this array's elements into a new array of the specified newLength. If newLength is < 0, the new array's size matches this array, otherwise the new array is truncated or padded with null as newLength differs from this array's length.

Parameters:

newLength - The length of the new array. If < 0, the resulting array's length matches this array, otherwise the resulting array is truncated or padded with null accordingly.

Returns:

A newly allocated array with elements corresponding with this array.

copyTo

public static Object copyTo(Object array,
                            Object to)

Copies the elements of this array to a specified array, truncating or padding with nulls as needed.

copyRange

public static Object copyRange(Object array,
                               int from,
                               int to)

Copies a range of elements from this array to a newly allocated array. Note, if to < 0, the range contains the remainder of this array's elements.

Parameters:

from - The start point of the range, inclusive.

to - The endpoint of the range, exclusive. A negative value may be used as a convenience to use this array's endpoint.

Returns:

A newly allocated array containing the specified range of elements from this array.

copyRangeTo

public static Object copyRangeTo(Object array,
                                 int from,
                                 int to,
                                 Object target,
                                 int targetIndex)

Copies a range of elements from this array to the target array. Note, if to < 0, the range contains the remainder of this array's elements.

Parameters:

from - The starting point of the range, inclusive.

to - The endpoint of the range, exclusive. A negative value may be used as a convenience to use this array's endpoint.

Returns:

The target array containing the specified range of elements from this array.

stream

public static Stream<Object> stream(Object array)

Returns a sequential Stream with this array as its source. Note, this array is assumed to be unmodified during use

Returns:

A Stream for the array

forEach

public static void forEach(Object array,
                           IndexedConsumer<? super Object> action)

spliterator

public static Spliterator<Object> spliterator(Object array)

binarySearch

public static int binarySearch(Object array,
                               Object key)

binarySearch

public static int binarySearch(Object array,
                               int from,
                               int to,
                               Object key)

binarySearch

public static int binarySearch(Object array,
                               Object key,
                               Comparator<? super Object> comparator)

binarySearch

public static int binarySearch(Object array,
                               int from,
                               int to,
                               Object key,
                               Comparator<? super Object> comparator)

toString

public static String toString(Object array)

hashCode

public static int hashCode(Object array)

equals

public static boolean equals(Object array,
                             Object that)