com.landawn.abacus.util

Class Hex

java.lang.Object

com.landawn.abacus.util.Hex

public class Hex
extends java.lang.Object

Note: copied from Apache commons-codec: https://commons.apache.org/proper/commons-codec. Converts hexadecimal Strings. The charset used for certain operation can be set, the default is set in #DEFAULT_CHARSET_NAME This class is thread-safe.

Since:

1.1

Version:

$Id: Hex.java 1619948 2014-08-22 22:53:55Z ggregory $

Constructor Summary

Constructors

Constructor and Description
Hex()

Method Summary

Modifier and Type	Method and Description
static byte[]	decode(char[] data) Converts an array of characters representing hexadecimal values into an array of bytes of those same values.
static byte[]	decode(java.lang.String data)
static char[]	encode(byte[] data) Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order.
static char[]	encode(byte[] data, boolean toLowerCase) Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order.
static java.lang.String	encodeToString(byte[] data) Converts an array of bytes into a String representing the hexadecimal values of each byte in order.
static java.lang.String	encodeToString(byte[] data, boolean toLowerCase) Converts an array of bytes into a String representing the hexadecimal values of each byte in order.

Methods inherited from class java.lang.Object

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

Constructor Detail

Hex

public Hex()

Method Detail

encode

public static char[] encode(byte[] data)

Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order. The returned array will be double the length of the passed array, as it takes two characters to represent any given byte.

Parameters:

data - a byte[] to convert to Hex characters

Returns:

A char[] containing hexadecimal characters

encode

public static char[] encode(byte[] data,
                            boolean toLowerCase)

Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order. The returned array will be double the length of the passed array, as it takes two characters to represent any given byte.

Parameters:

data - a byte[] to convert to Hex characters

toLowerCase - true converts to lowercase, false to uppercase

Returns:

A char[] containing hexadecimal characters

Since:

1.4

encodeToString

public static java.lang.String encodeToString(byte[] data)

Converts an array of bytes into a String representing the hexadecimal values of each byte in order. The returned String will be double the length of the passed array, as it takes two characters to represent any given byte.

Parameters:

data - a byte[] to convert to Hex characters

Returns:

A String containing hexadecimal characters

Since:

1.4

encodeToString

public static java.lang.String encodeToString(byte[] data,
                                              boolean toLowerCase)

Converts an array of bytes into a String representing the hexadecimal values of each byte in order. The returned String will be double the length of the passed array, as it takes two characters to represent any given byte.

Parameters:

data - a byte[] to convert to Hex characters

toLowerCase - true converts to lowercase, false to uppercase

Returns:

A String containing hexadecimal characters

Since:

1.4

decode

public static byte[] decode(java.lang.String data)
                     throws java.lang.IllegalArgumentException

Throws:

java.lang.IllegalArgumentException

decode

public static byte[] decode(char[] data)
                     throws java.lang.IllegalArgumentException

Converts an array of characters representing hexadecimal values into an array of bytes of those same values. The returned array will be half the length of the passed array, as it takes two characters to represent any given byte. An exception is thrown if the passed char array has an odd number of elements.

Parameters:

data - An array of characters containing hexadecimal digits

Returns:

A byte array containing binary data decoded from the supplied char array.

Throws:

DecoderException - Thrown if an odd number or illegal of characters is supplied

java.lang.IllegalArgumentException