io.appulse.utils

Class HexUtil

java.lang.Object

io.appulse.utils.HexUtil

public final class HexUtil
extends Object

The set of different HEX helper funtions.

Since:

1.16.0

Author:

Artem Labazin

Method Summary

Modifier and Type	Method and Description
static char	byteToChar(int value) Converts an integer value into char.
static String	byteToHex(int value) Converts an integer value into two-chars string with leading 0.
static String	prettyHexDump(@NonNull byte[] bytes) Returns a multi-line hexadecimal dump of the specified byte array that is easy to read by humans.
static String	prettyHexDump(@NonNull Bytes buffer) Returns a multi-line hexadecimal dump of the specified Bytes that is easy to read by humans.
static String	prettyHexDump(@NonNull Bytes buffer, int offset, int length) Returns a multi-line hexadecimal dump of the specified Bytes that is easy to read by humans, starting at the given offset using the given length.
static byte[]	toByteArray(@NonNull String string) Converts the string argument into an array of bytes.
static String	toHexString(@NonNull byte[] bytes) Converts an array of bytes into a string.

Methods inherited from class java.lang.Object

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

Method Detail

toHexString

public static String toHexString(@NonNull
                                 @NonNull byte[] bytes)

Converts an array of bytes into a string.

Parameters:

bytes - an array of bytes

Returns:

a string containing a lexical representation of HEX binary

Throws:

NullpointerException - if bytes is null.

Since:

1.16.1

toByteArray

public static byte[] toByteArray(@NonNull
                                 @NonNull String string)

Converts the string argument into an array of bytes.

Parameters:

string - a string containing lexical representation of HEX binary.

Returns:

an array of bytes represented by the string argument.

Throws:

NullpointerException - if string is null.

IllegalArgumentException - if string parameter does not conform to lexical value space defined for HEX binary.

Since:

1.16.1

byteToHex

public static String byteToHex(int value)

Converts an integer value into two-chars string with leading 0.

Parameters:

value - the value to convert

Returns:

the result string

byteToChar

public static char byteToChar(int value)

Converts an integer value into char.

Parameters:

value - the value to convert

Returns:

the value's char representation

prettyHexDump

public static String prettyHexDump(@NonNull
                                   @NonNull byte[] bytes)

Returns a multi-line hexadecimal dump of the specified byte array that is easy to read by humans.

Parameters:

bytes - the byte array to dump

Returns:

the human-readable multi-line hexadecimal dump

prettyHexDump

public static String prettyHexDump(@NonNull
                                   @NonNull Bytes buffer)

Returns a multi-line hexadecimal dump of the specified Bytes that is easy to read by humans.

Parameters:

buffer - the byte array buffer to dump

Returns:

the human-readable multi-line hexadecimal dump

prettyHexDump

public static String prettyHexDump(@NonNull
                                   @NonNull Bytes buffer,
                                   int offset,
                                   int length)

Returns a multi-line hexadecimal dump of the specified Bytes that is easy to read by humans, starting at the given offset using the given length.

Parameters:

buffer - the byte array buffer to dump

offset - the buffer's offset

length - the dump's length

Returns:

the human-readable multi-line hexadecimal dump