org.zkoss.util
Class ArraysX

java.lang.Object
  org.zkoss.util.ArraysX

public class ArraysX
extends Object

Utilities for handling arrays.

Author:

henrichen

Constructor Summary

ArraysX()

Method Summary

static Object	clone(Object ary) Clones an array.
static Object	concat(Object ary, Object ary1) Concat the two specified array.
static Object	duplicate(Object ary) Duplicates the specified array.
static Object	duplicate(Object ary, int jb, int je) Duplicates the specified array.
static Object	resize(Object ary, int size) Resizes the specified array.
static Object	shrink(Object ary, int jb, int je) Shrink the specified array.
static String	toHexString(byte[] array) Returns the hex String representation of a byte array without prefix 0x.
static String	toOctalString(byte[] array, String prefix) Returns the octal String representation of a byte array with optional prefix.
static String	toString(boolean[] array) Converts an array of boolean to a readable string (for debugging purpose).
static String	toString(byte[] array) Converts an array of byte to a readable string (for debugging purpose).
static String	toString(char[] array) Converts an array of char to a readable string (for debugging purpose).
static String	toString(double[] array) Converts an array of char to a readable string (for debugging purpose).
static String	toString(float[] array) Converts an array of float to a readable string (for debugging purpose).
static String	toString(int[] array) Converts an array of int to a readable string (for debugging purpose).
static String	toString(long[] array) Converts an array of long to a readable string (for debugging purpose).
static String	toString(Object[] array) Converts an array to a readable string (for debugging purpose).
static String	toString(short[] array) Converts an array of short to a readable string (for debugging purpose).

Methods inherited from class java.lang.Object

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

Constructor Detail

ArraysX

public ArraysX()

Method Detail

toString

public static final String toString(Object[] array)

Converts an array to a readable string (for debugging purpose).

toString

public static final String toString(int[] array)

Converts an array of int to a readable string (for debugging purpose).

toString

public static final String toString(long[] array)

Converts an array of long to a readable string (for debugging purpose).

toString

public static final String toString(short[] array)

Converts an array of short to a readable string (for debugging purpose).

toString

public static final String toString(byte[] array)

Converts an array of byte to a readable string (for debugging purpose).

toString

public static final String toString(char[] array)

Converts an array of char to a readable string (for debugging purpose).

toString

public static final String toString(boolean[] array)

Converts an array of boolean to a readable string (for debugging purpose).

toString

public static final String toString(float[] array)

Converts an array of float to a readable string (for debugging purpose).

toString

public static final String toString(double[] array)

Converts an array of char to a readable string (for debugging purpose).

toHexString

public static final String toHexString(byte[] array)

Returns the hex String representation of a byte array without prefix 0x. The String is formed by making value[0] the leftmost two digits and value[value.length-1] the rightmost two digits.

Parameters:

array - the byte array

toOctalString

public static final String toOctalString(byte[] array,
                                         String prefix)

Returns the octal String representation of a byte array with optional prefix. The String is formed by making value[0] the leftmost three digits and value[value.length-1] the rightmost three digits.

Parameters:

array - the byte array

duplicate

public static final Object duplicate(Object ary,
                                     int jb,
                                     int je)

Duplicates the specified array.

The array could be an array of objects or primiitives.

Parameters:

ary - the array

jb - the beginning index (included)

je - the ending index (excluded)

Returns:

an array duplicated from ary

Throws:

IllegalArgumentException - if ary is not any array

IndexOutOfBoundsException - if out of bounds

duplicate

public static final Object duplicate(Object ary)

Duplicates the specified array.

Parameters:

ary - the array

Returns:

an array duplicated from ary

Throws:

IllegalArgumentException - if ary is not any array

IndexOutOfBoundsException - if out of bounds

concat

public static final Object concat(Object ary,
                                  Object ary1)

Concat the two specified array.

The array could be an array of objects or primiitives.

Parameters:

ary - the array

ary1 - the array

Returns:

an array concat the ary and ary1

Throws:

IllegalArgumentException - if ary and ary1 component types are not compatible

shrink

public static final Object shrink(Object ary,
                                  int jb,
                                  int je)

Shrink the specified array. It is similar to duplicate, except it returns the previous instance if je==length && jb==0.

Parameters:

ary - the array

jb - the beginning index (included)

je - the ending index (excluded)

Returns:

ary or an array duplicated from ary

Throws:

IllegalArgumentException - if ary is not any array

IndexOutOfBoundsException - if out of bounds

resize

public static final Object resize(Object ary,
                                  int size)

Resizes the specified array. Similar to shrink(java.lang.Object, int, int), but it can enlarge and it keeps elements from the first.

clone

public static final Object clone(Object ary)

Clones an array.