Package com.tailf.util

Class ArrayTool

Object

com.tailf.util.ArrayTool

public class ArrayTool
extends Object

Tools for array manipulation.

Method Summary

Modifier and Type	Method	Description
static Object[]	concatArrays(Object[] a, Object o)	Appends an object to the end of an array, creating a new array.
static Object[]	concatArrays(Object[] a, Object[] b)	Concatenates two arrays into a new array.
static <T> T[]	copyOfRange(T[] original, int from, int to)	Returns a subarray from the original array from from to to.

Methods inherited from class java.lang.Object

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

Method Details

concatArrays

public static Object[] concatArrays(Object[] a,
 Object[] b)

Concatenates two arrays into a new array.

Parameters:

a - first array to concatenate

b - second array to concatenate

Returns:

new array containing elements from both arrays

copyOfRange

public static <T> T[] copyOfRange(T[] original,
 int from,
 int to)

Returns a subarray from the original array from from to to. Copies the specified range of the specified array into a new array.

The initial index of the range (from) must lie between zero and original.length, inclusive. The value at original[from] is placed into the initial element of the copy (unless from == original.length or from == to).

Values from subsequent elements in the original array are placed into subsequent elements in the copy. The final index of the range (to), which must be greater than or equal to from, may be greater than original.length, in which case null is placed in all elements of the copy whose index is greater than or equal to original.length - from. The length of the returned array will be to - from.

The resulting array is of exactly the same class as the original array.

Type Parameters:

T - the type of array elements

Parameters:

original - the array from which a range is to be copied

from - the initial index of the range to be copied, inclusive

to - the final index of the range to be copied, exclusive. (This index may lie outside the array.)

Returns:

a new array containing the specified range from the original array, truncated or padded with nulls to obtain the required length

Throws:

ArrayIndexOutOfBoundsException - if from < 0 or from > original.length

IllegalArgumentException - if from > to

NullPointerException - if original is null

concatArrays

public static Object[] concatArrays(Object[] a,
 Object o)

Appends an object to the end of an array, creating a new array.

Parameters:

a - source array

o - object to append

Returns:

new array with the object appended