org.atlanmod.commons.primitive

Class Bytes

java.lang.Object

org.atlanmod.commons.primitive.Bytes

@ParametersAreNonnullByDefault
public final class Bytes
extends Object

Static utility methods related to byte arrays.

Method Summary

Modifier and Type	Method and Description
static List<Byte>	asList(byte... primitiveArray) Converts a byte array into a List of Byte.
static byte[]	toArray(List<Byte> boxedList) Converts a List of Byte into a byte array.
static boolean	toBoolean(byte[] bytes) Decodes a byte array to a boolean.
static char	toChar(byte[] bytes) Decodes a byte array to a char.
static double	toDouble(byte[] bytes) Decodes a byte array to a double.
static float	toFloat(byte[] bytes) Decodes a byte array to a float.
static int	toInt(byte[] bytes) Decodes a byte array to an int.
static long	toLong(byte[] bytes) Decodes a byte array to a long.
static short	toShort(byte[] bytes) Decodes a byte array to a short.
static String	toString(byte[] bytes) Decodes a byte array to a String.
static String	toStringBinary(byte[] bytes) Decodes a byte array to a String that contains each byte, in order, as a two-digit unsigned hexadecimal number in lower case.

Methods inherited from class java.lang.Object

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

Method Detail

toBoolean

public static boolean toBoolean(byte[] bytes)

Decodes a byte array to a boolean.

Parameters:

bytes - the byte array to decode

Returns:

a boolean

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if the bytes.length is different from 1

toShort

public static short toShort(byte[] bytes)

Decodes a byte array to a short.

Parameters:

bytes - the byte array to decode

Returns:

a short

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if the bytes.length is different from Short.BYTES

toChar

public static char toChar(byte[] bytes)

Decodes a byte array to a char.

Parameters:

bytes - the byte array to decode

Returns:

a char

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if the bytes.length is different from Character.BYTES

See Also:

toShort(byte[])

toInt

public static int toInt(byte[] bytes)

Decodes a byte array to an int.

Parameters:

bytes - the byte array to decode

Returns:

an int

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if the bytes.length is different from Integer.BYTES

toLong

public static long toLong(byte[] bytes)

Decodes a byte array to a long.

Parameters:

bytes - the byte array to decode

Returns:

a long

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if the bytes.length is different from Long.BYTES

toFloat

public static float toFloat(byte[] bytes)

Decodes a byte array to a float.

Parameters:

bytes - the byte array to decode

Returns:

a float

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if the bytes.length is different from Float.BYTES

See Also:

toInt(byte[]), Float.intBitsToFloat(int)

toDouble

public static double toDouble(byte[] bytes)

Decodes a byte array to a double.

Parameters:

bytes - the byte array to decode

Returns:

a double

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if the bytes.length is different from Double.BYTES

See Also:

toLong(byte[]), Double.longBitsToDouble(long)

toString

@Nonnull
public static String toString(byte[] bytes)

Decodes a byte array to a String.

Parameters:

bytes - the byte array to decode

Returns:

a String

Throws:

NullPointerException - if the bytes is null

IllegalArgumentException - if StandardCharsets.UTF_8 is not a supported encoding

toStringBinary

@Nonnull
public static String toStringBinary(byte[] bytes)

Decodes a byte array to a String that contains each byte, in order, as a two-digit unsigned hexadecimal number in lower case.

Parameters:

bytes - the byte array to decode

Returns:

a String

Throws:

NullPointerException - if the bytes is null

See Also:

Strings.toBytesBinary(String)

asList

@Nonnull
public static List<Byte> asList(byte... primitiveArray)

Converts a byte array into a List of Byte.

Parameters:

primitiveArray - the byte array to convert

Returns:

A List containing the same elements as primitiveArray, in the same order, coverted to wrapper objects.

toArray

@Nonnull
public static byte[] toArray(List<Byte> boxedList)

Converts a List of Byte into a byte array.

Parameters:

boxedList - the List of Byte to convert.

Returns:

an array containing the same elements as boxedList, in the same order, converted to primitives.