org.arp.javautil.arrays

Class Arrays

java.lang.Object

org.arp.javautil.arrays.Arrays

public final class Arrays
extends Object

Utilities for arrays.

Author:

Andrew Post

Method Summary

Modifier and Type	Method and Description
static <E> void	addAll(Collection<E> collection, E[]... arr) Adds the contents of one or more arrays to a collection.
static <E> List<E>	asList(E[]... arrs) Returns a newly created random access list with the contents of the provided arrays.
static <E> Set<E>	asSet(E[] objs) Returns a Set (specfically, a HashSet) with all the unique elements from the given array of objects.
static boolean	contains(Object[] arr, Object obj) Returns where an object is in a given array.
static void	matrixCopy(Object[][] src, Object[][] dest) Copies a 2D array.
static void	matrixFill(Object[][] matrix, Object val) Fills a 2D array with a value.

Methods inherited from class java.lang.Object

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

Method Detail

matrixCopy

public static void matrixCopy(Object[][] src,
                              Object[][] dest)

Copies a 2D array. Nothing happens if either argument is null.

Parameters:

src - an array.

dest - an array.

matrixFill

public static void matrixFill(Object[][] matrix,
                              Object val)

Fills a 2D array with a value. Nothing happens if matrix is null. Likewise, nothing happens to a null row.

Parameters:

matrix - a 2D Object[] array.

val - an Object value.

contains

public static boolean contains(Object[] arr,
                               Object obj)

Returns where an object is in a given array.

Parameters:

arr - the Object[] to search.

obj - the Object to search for.

Returns:

true of obj is in arr, false otherwise. Returns false if arr is null.

asSet

public static <E> Set<E> asSet(E[] objs)

Returns a Set (specfically, a HashSet) with all the unique elements from the given array of objects. The set is mutable.

Parameters:

objs - An array of objects.

Returns:

A Set object containing all the unique elements from the array.

addAll

@SafeVarargs
public static <E> void addAll(Collection<E> collection,
                                           E[]... arr)

Adds the contents of one or more arrays to a collection.

Parameters:

collection - a Collection. Cannot be null.

arr - zero or more E[].

asList

@SafeVarargs
public static <E> List<E> asList(E[]... arrs)

Returns a newly created random access list with the contents of the provided arrays.

Type Parameters:

E - any class.

Parameters:

arrs - one or more E[].

Returns:

a newly created random access List.