ch.bind.philib.lang

Class ArrayUtil

java.lang.Object

ch.bind.philib.lang.ArrayUtil

public abstract class ArrayUtil
extends Object

Various functions for dealing with arrays which are not present in the standard Arrays class.

Since:

2009-06-10

Author:

Philipp Meinen

Field Summary

Fields

Modifier and Type	Field and Description
static byte[]	EMPTY_BYTE_ARRAY
static char[]	EMPTY_CHAR_ARRAY
static double[]	EMPTY_DOUBLE_ARRAY
static float[]	EMPTY_FLOAT_ARRAY
static int[]	EMPTY_INT_ARRAY
static long[]	EMPTY_LONG_ARRAY
static short[]	EMPTY_SHORT_ARRAY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ArrayUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	append(byte[] a, byte[] b, int capacity) append the content of two byte arrays up to a certain capacity limit
static <T> T[]	append(Class<T> clazz, T[] a, T b)
static byte[]	concat(byte[] a, byte[] b) concatenate the content of two byte arrays.
static boolean	contains(byte[] data, byte[] search)
static byte[]	extractBack(byte[] data, int len)
static byte[]	extractFront(byte[] data, int len)
static int	find(byte[] data, byte[] search)
static int	find(byte[] data, byte[] search, int dataOffset)
static String	formatShortHex(byte[] data)
static String	formatShortHex(byte[] data, int off, int len)
static String	formatShortHex(ByteBuffer data)
static String	formatShortHex(ByteBuffer data, int len)
static void	memclr(byte[] buf) Overwrites the buffer's content with zeros.
static void	memclr(ByteBuffer buf) Overwrites the buffer's content with zeros.
static <T> T[]	newArray(Class<T> clazz, int size) shorthand for java.lang.reflect.Array.newInstance(clazz, size)
static <T> void	pickRandom(T[] source, T[] destination) Fills the destination array with randomly picked values from the source array.
static <T> T[]	prepend(Class<T> clazz, T[] a, T b)
static <T> T[]	remove(Class<T> clazz, T[] from, T what)
static <T> T[]	toArray(Class<T> clazz, Collection<? extends T> collection)

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_BYTE_ARRAY

public static final byte[] EMPTY_BYTE_ARRAY

EMPTY_CHAR_ARRAY

public static final char[] EMPTY_CHAR_ARRAY

EMPTY_SHORT_ARRAY

public static final short[] EMPTY_SHORT_ARRAY

EMPTY_INT_ARRAY

public static final int[] EMPTY_INT_ARRAY

EMPTY_LONG_ARRAY

public static final long[] EMPTY_LONG_ARRAY

EMPTY_FLOAT_ARRAY

public static final float[] EMPTY_FLOAT_ARRAY

EMPTY_DOUBLE_ARRAY

public static final double[] EMPTY_DOUBLE_ARRAY

Constructor Detail

ArrayUtil

protected ArrayUtil()

Method Detail

newArray

public static <T> T[] newArray(Class<T> clazz,
               int size)

shorthand for java.lang.reflect.Array.newInstance(clazz, size)

Parameters:

clazz - -

size - -

Returns:

-

pickRandom

public static <T> void pickRandom(T[] source,
                  T[] destination)

Fills the destination array with randomly picked values from the source array. No value will be picked twice.

Parameters:

source - The array from which random values must be picked. The content of this array will not be altered.

destination - The array which must be filled with random values. Previous values within this array will be overwritten.

Throws:

NullPointerException - If either of the two parameters is null.

IllegalArgumentException - If the source-array is smaller than the destination -array.

concat

public static byte[] concat(byte[] a,
            byte[] b)

concatenate the content of two byte arrays.

Parameters:

a - the first byte array (may be null)

b - the second byte array (may be null)

Returns:

a new byte array with the combined length of a and b, containing a copy of their content.

append

public static byte[] append(byte[] a,
            byte[] b,
            int capacity)

append the content of two byte arrays up to a certain capacity limit

Parameters:

a - the first byte array (may be null)

b - the second byte array (may be null)

Returns:

a new byte array with the combined length of a and b, containing a copy of their content. if the combined length exceeds capacity the returned array a will have a.length == capacity.

prepend

public static <T> T[] prepend(Class<T> clazz,
              T[] a,
              T b)

append

public static <T> T[] append(Class<T> clazz,
             T[] a,
             T b)

remove

public static <T> T[] remove(Class<T> clazz,
             T[] from,
             T what)

extractBack

public static byte[] extractBack(byte[] data,
                 int len)

extractFront

public static byte[] extractFront(byte[] data,
                  int len)

contains

public static boolean contains(byte[] data,
               byte[] search)

find

public static int find(byte[] data,
       byte[] search)

find

public static int find(byte[] data,
       byte[] search,
       int dataOffset)

formatShortHex

public static String formatShortHex(byte[] data)

formatShortHex

public static String formatShortHex(byte[] data,
                    int off,
                    int len)

formatShortHex

public static String formatShortHex(ByteBuffer data,
                    int len)

formatShortHex

public static String formatShortHex(ByteBuffer data)

memclr

public static void memclr(ByteBuffer buf)

Overwrites the buffer's content with zeros.

Parameters:

buf - -

memclr

public static void memclr(byte[] buf)

Overwrites the buffer's content with zeros.

Parameters:

buf - -

toArray

public static <T> T[] toArray(Class<T> clazz,
              Collection<? extends T> collection)