de.intarsys.tools.collection

Class ByteArrayTools

java.lang.Object

de.intarsys.tools.collection.ByteArrayTools

public class ByteArrayTools
extends Object

Constructor Summary

Constructors

Constructor and Description
ByteArrayTools()

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	concat(byte[]... arrays) Concatenate the byte array arguments.
static byte[]	copy(byte[] bytes) Make a copy of bytes.
static byte[]	copy(byte[] bytes, int offset, int length) Copy length bytes from bytes starting at from.
static byte[]	createBytes(int length, byte val) A byte array with the defined length, filled with val.
static byte[]	createBytes(Object value) Basic byte[] conversion.
static byte[]	createRandomBytes(int length) A random byte sequence of length length.
static boolean	equals(byte[] array1, int offset1, byte[] array2, int offset2, int length) Checks two arrays or sections thereof for equality.
static int	indexOf(byte[] source, int sourceOffset, int sourceLen, byte[] pattern, int patternOffset, int patternLen, int fromIndex) Search index of pattern in source.
static boolean	startsWith(byte[] bytes, byte[] pattern) true if bytes starts with the byte sequence defined in pattern.
static void	toBigEndianArray(byte[] bytes, int offset, int value, int size) Write value into bytes, starting at offset, most significant byte first, using size bytes
static byte[]	toBigEndianArray(int value, int size) Create bytes from value, most significant byte first, using size bytes
static int	toBigEndianInt(byte[] buffer, int offset, int size) Create a signed int from buffer, starting at offset and using size bytes, most significant byte first.
static int	toBigEndianIntUnsigned(byte[] buffer, int offset, int size) Create an unsigned int from buffer, starting at offset and using size bytes, most significant byte first.
static long	toBigEndianLong(byte[] buffer, int offset, int size) Create a signed long from buffer, starting at offset and using size bytes, most significant byte first.
static long	toBigEndianLongUnsigned(byte[] buffer, int offset, int size) Create an unsigned long from buffer, starting at offset and using size bytes, most significant byte first.
static byte[]	toByteArray(BigInteger r) Return r as an byte array without leading zero bytes.
static void	toLittleEndianArray(byte[] bytes, int offset, int value, int size) Write value into bytes, starting at offset, least significant byte first, using size bytes
static void	toLittleEndianArray(byte[] bytes, int offset, long value, int size) Write value into bytes, starting at offset, least significant byte first, using size bytes
static byte[]	toLittleEndianArray(int value, int size) Create byte array from value, least significant byte first, using size bytes
static byte[]	toLittleEndianArray(long value, int size) Create byte array from value, least significant byte first, using size bytes
static int	toLittleEndianInt(byte[] buffer, int offset, int size) Create a signed int from buffer, starting at offset and using size bytes, least significant byte first.
static int	toLittleEndianIntUnsigned(byte[] buffer, int offset, int size) Create an unsigned int from buffer, starting at offset and using size bytes, least significant byte first.
static long	toLittleEndianLong(byte[] buffer, int offset, int size) Create a signed long from buffer, starting at offset and using size bytes, least significant byte first.
static long	toLittleEndianLongUnsigned(byte[] buffer, int offset, int size) Create an unsigned long from buffer, starting at offset and using size bytes, least significant byte first.

Methods inherited from class java.lang.Object

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

Constructor Detail

ByteArrayTools

public ByteArrayTools()

Method Detail

concat

public static byte[] concat(byte[]... arrays)

Concatenate the byte array arguments.

Parameters:

array -

Returns:

copy

public static byte[] copy(byte[] bytes)

Make a copy of bytes.

Parameters:

bytes - byte[] to be copied

Returns:

A copy of bytes

copy

public static byte[] copy(byte[] bytes,
          int offset,
          int length)

Copy length bytes from bytes starting at from.

Parameters:

bytes - byte[] to be copied

offset - starting position to copy from

length - number of bytes

Returns:

A copy of bytes

createBytes

public static byte[] createBytes(int length,
                 byte val)

A byte array with the defined length, filled with val.

Parameters:

length -

val -

Returns:

A byte array with the defined length, filled with val.

createBytes

public static byte[] createBytes(Object value)
                          throws IOException

Basic byte[] conversion.

Parameters:

value -

Returns:

Throws:

IOException

createRandomBytes

public static byte[] createRandomBytes(int length)

A random byte sequence of length length.

Parameters:

length -

Returns:

A random byte sequence of length length.

equals

public static boolean equals(byte[] array1,
             int offset1,
             byte[] array2,
             int offset2,
             int length)

Checks two arrays or sections thereof for equality. If an array is null or it's section is shorter than the compared length, false is returned.

Parameters:

array1 -

offset1 -

array2 -

offset2 -

length - must have a value greater than 0. A value of 0 always returns false.

Returns:

true, if the compared array sections match

indexOf

public static int indexOf(byte[] source,
          int sourceOffset,
          int sourceLen,
          byte[] pattern,
          int patternOffset,
          int patternLen,
          int fromIndex)

Search index of pattern in source. Algorithm from java.lang.String

Parameters:

source -

sourceOffset -

sourceLen -

pattern -

patternOffset -

patternLen -

fromIndex -

Returns:

The index of the first occurrence of pattern or -1.

startsWith

public static boolean startsWith(byte[] bytes,
                 byte[] pattern)

true if bytes starts with the byte sequence defined in pattern.

Parameters:

bytes -

pattern -

Returns:

true if bytes starts with the byte sequence defined in pattern.

toBigEndianArray

public static void toBigEndianArray(byte[] bytes,
                    int offset,
                    int value,
                    int size)

Write value into bytes, starting at offset, most significant byte first, using size bytes

Parameters:

bytes -

offset -

value -

size -

toBigEndianArray

public static byte[] toBigEndianArray(int value,
                      int size)

Create bytes from value, most significant byte first, using size bytes

Parameters:

bytes -

offset -

value -

size -

toBigEndianInt

public static int toBigEndianInt(byte[] buffer,
                 int offset,
                 int size)

Create a signed int from buffer, starting at offset and using size bytes, most significant byte first.

Parameters:

buffer -

offset -

size -

Returns:

toBigEndianIntUnsigned

public static int toBigEndianIntUnsigned(byte[] buffer,
                         int offset,
                         int size)

Create an unsigned int from buffer, starting at offset and using size bytes, most significant byte first.

Parameters:

buffer -

offset -

size -

Returns:

toBigEndianLong

public static long toBigEndianLong(byte[] buffer,
                   int offset,
                   int size)

Create a signed long from buffer, starting at offset and using size bytes, most significant byte first.

Parameters:

buffer -

offset -

size -

Returns:

toBigEndianLongUnsigned

public static long toBigEndianLongUnsigned(byte[] buffer,
                           int offset,
                           int size)

Create an unsigned long from buffer, starting at offset and using size bytes, most significant byte first.

Parameters:

buffer -

offset -

size -

Returns:

toByteArray

public static byte[] toByteArray(BigInteger r)

Return r as an byte array without leading zero bytes.

Parameters:

r -

Returns:

toLittleEndianArray

public static void toLittleEndianArray(byte[] bytes,
                       int offset,
                       int value,
                       int size)

Write value into bytes, starting at offset, least significant byte first, using size bytes

Parameters:

bytes -

offset -

value -

size -

toLittleEndianArray

public static void toLittleEndianArray(byte[] bytes,
                       int offset,
                       long value,
                       int size)

Write value into bytes, starting at offset, least significant byte first, using size bytes

Parameters:

bytes -

offset -

value -

size -

toLittleEndianArray

public static byte[] toLittleEndianArray(int value,
                         int size)

Create byte array from value, least significant byte first, using size bytes

Parameters:

value -

size -

toLittleEndianArray

public static byte[] toLittleEndianArray(long value,
                         int size)

Create byte array from value, least significant byte first, using size bytes

Parameters:

value -

size -

toLittleEndianInt

public static int toLittleEndianInt(byte[] buffer,
                    int offset,
                    int size)

Create a signed int from buffer, starting at offset and using size bytes, least significant byte first.

Parameters:

buffer -

offset -

size -

Returns:

toLittleEndianIntUnsigned

public static int toLittleEndianIntUnsigned(byte[] buffer,
                            int offset,
                            int size)

Create an unsigned int from buffer, starting at offset and using size bytes, least significant byte first.

This implementation does not check against integer overflow

Parameters:

buffer -

offset -

size -

Returns:

toLittleEndianLong

public static long toLittleEndianLong(byte[] buffer,
                      int offset,
                      int size)

Create a signed long from buffer, starting at offset and using size bytes, least significant byte first.

Parameters:

buffer -

offset -

size -

Returns:

toLittleEndianLongUnsigned

public static long toLittleEndianLongUnsigned(byte[] buffer,
                              int offset,
                              int size)

Create an unsigned long from buffer, starting at offset and using size bytes, least significant byte first.

This implementation does not check against integer overflow

Parameters:

buffer -

offset -

size -

Returns: