org.radix.utils.primitives

Class Bytes

java.lang.Object

org.radix.utils.primitives.Bytes

public class Bytes
extends java.lang.Object

Utility class for manipulating primitive bytes.

Method Summary

Modifier and Type	Method and Description
static boolean	arrayEquals(byte[] a1, int offset1, int length1, byte[] a2, int offset2, int length2) Compare two byte array segments for equality.
static byte[]	fromBase64String(java.lang.String s) Convert a base-64 encoded string into an array of bytes using RFC 4648 rules.
static byte[]	fromHexString(java.lang.String s) Convert a string of hexadecimal digits to an array of bytes.
static int	hashCode(byte[] a, int offset, int length) Calculate hash code of a byte array segment.
static java.lang.String	toBase64String(byte[] bytes) Convert an array of bytes into a Base-64 encoded using RFC 4648 rules.
static java.lang.String	toHexString(byte b) Convert a byte into a two-digit hex string.
static java.lang.String	toHexString(byte[] bytes) Convert an array into a string of hex digits.
static java.lang.String	toHexString(byte[] bytes, int offset, int length) Convert a portion of an array into a string of hex digits.
static java.lang.String	toString(byte[] bytes) Convert a byte array into a String using the RadixConstants.STANDARD_CHARSET character set.
static byte[]	trimLeadingZeros(byte[] bytes) Trims any leading zero bytes from bytes until either no leading zero exists, or only a single zero byte exists.

Methods inherited from class java.lang.Object

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

Method Detail

arrayEquals

public static boolean arrayEquals(byte[] a1,
                                  int offset1,
                                  int length1,
                                  byte[] a2,
                                  int offset2,
                                  int length2)

Compare two byte array segments for equality.

Parameters:

a1 - The first array to compare

offset1 - The offset within a1 to begin the comparison

length1 - The quantity of a1 to compare

a2 - The second array to compare

offset2 - The offset within a2 to begin the comparison

length2 - The quantity of a2 to compare

Returns:

true iff length1 == length2 and a1[offset1 + i] == a2[offset2 + i] for i ∈ [0, length1).

hashCode

public static int hashCode(byte[] a,
                           int offset,
                           int length)

Calculate hash code of a byte array segment.

Parameters:

a - The array for which to calculate the hash code.

offset - The offset within the array to start the calculation.

length - The number of bytes for which to calculate the hash code.

Returns:

The hash code.

toString

public static java.lang.String toString(byte[] bytes)

Convert a byte array into a String using the RadixConstants.STANDARD_CHARSET character set.

Parameters:

bytes - The bytes to convert.

Returns:

The string

toHexString

public static java.lang.String toHexString(byte b)

Convert a byte into a two-digit hex string.

Note that digits a-f are output as lower case.

Parameters:

b - The byte to convert

Returns:

The converted string

toHexString

public static java.lang.String toHexString(byte[] bytes)

Convert an array into a string of hex digits.

The output string will have length 2*bytes.length. Hex digits a-f are encoded as lower case.

Parameters:

bytes - The bytes to convert

Returns:

The converted string

toHexString

public static java.lang.String toHexString(byte[] bytes,
                                           int offset,
                                           int length)

Convert a portion of an array into a string of hex digits.

The output string will have length 2*length. Hex digits a-f are encoded as lower case.

Parameters:

bytes - The bytes to convert

offset - The offset at which to start converting

length - The number of bytes to convert

Returns:

The converted string

fromHexString

public static byte[] fromHexString(java.lang.String s)

Convert a string of hexadecimal digits to an array of bytes.

If the string length is odd, a leading '0' is assumed.

Parameters:

s - The string to convert to a byte array.

Returns:

The byte array corresponding to the converted string

Throws:

java.lang.IllegalArgumentException - if any character in s is not a hex digit

toBase64String

public static java.lang.String toBase64String(byte[] bytes)

Convert an array of bytes into a Base-64 encoded using RFC 4648 rules.

Parameters:

bytes - The bytes to encode

Returns:

The base-64 encoded string

fromBase64String

public static byte[] fromBase64String(java.lang.String s)

Convert a base-64 encoded string into an array of bytes using RFC 4648 rules.

Parameters:

s - The string to convert

Returns:

The decoded bytes

trimLeadingZeros

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

Trims any leading zero bytes from bytes until either no leading zero exists, or only a single zero byte exists.

Parameters:

bytes - the byte a

Returns:

bytes with leading zeros removed, if any