org.cryptacular.util

Class ByteUtil

java.lang.Object

org.cryptacular.util.ByteUtil

public final class ByteUtil
extends java.lang.Object

Utilities for working with bytes.

Field Summary

Fields

Modifier and Type	Field and Description
static java.nio.charset.Charset	ASCII_CHARSET ASCII charactr set.
static java.nio.charset.Charset	DEFAULT_CHARSET Default character set for bytes is UTF-8.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ByteUtil() Private constructor of utilty class.

Method Summary

Modifier and Type	Method and Description
static int	readInt(java.io.InputStream in) Reads 4-bytes from the input stream and converts to a 32-bit integer.
static long	readLong(java.io.InputStream in) Reads 8-bytes from the input stream and converts to a 64-bit long integer.
static byte[]	toArray(java.nio.ByteBuffer buffer) Converts a byte buffer into a byte array.
static java.nio.ByteBuffer	toByteBuffer(java.lang.String s) Converts a string into bytes in the UTF-8 character set.
static byte[]	toBytes(int value) Converts an integer into a 4-byte big endian array.
static void	toBytes(int value, byte[] output, int offset) Converts an integer into a 4-byte big endian array.
static byte[]	toBytes(long value) Converts a long integer into an 8-byte big endian array.
static void	toBytes(long value, byte[] output, int offset) Converts an integer into a 8-byte big endian array.
static byte[]	toBytes(java.lang.String s) Converts a string into bytes in the UTF-8 character set.
static java.nio.CharBuffer	toCharBuffer(java.nio.ByteBuffer buffer) Converts a byte buffer into a character buffer.
static int	toInt(byte[] data) Converts the big-endian representation of a 32-bit integer to the equivalent integer value.
static long	toLong(byte[] data) Converts the big-endian representation of a 64-bit integer to the equivalent long value.
static java.lang.String	toString(byte[] bytes) Converts a byte array into a string in the UTF-8 character set.
static java.lang.String	toString(java.nio.ByteBuffer buffer) Converts a byte buffer into a string in the UTF-8 character set.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CHARSET

public static final java.nio.charset.Charset DEFAULT_CHARSET

Default character set for bytes is UTF-8.

ASCII_CHARSET

public static final java.nio.charset.Charset ASCII_CHARSET

ASCII charactr set.

Constructor Detail

ByteUtil

private ByteUtil()

Private constructor of utilty class.

Method Detail

toInt

public static int toInt(byte[] data)

Converts the big-endian representation of a 32-bit integer to the equivalent integer value.

Parameters:

data - 4-byte array in big-endian format.

Returns:

Long integer value.

readInt

public static int readInt(java.io.InputStream in)
                   throws StreamException

Reads 4-bytes from the input stream and converts to a 32-bit integer.

Parameters:

in - Stream from which to read 4 bytes.

Returns:

Integer value.

Throws:

StreamException - on stream IO errors.

toLong

public static long toLong(byte[] data)

Converts the big-endian representation of a 64-bit integer to the equivalent long value.

Parameters:

data - 8-byte array in big-endian format.

Returns:

Long integer value.

readLong

public static long readLong(java.io.InputStream in)
                     throws StreamException

Reads 8-bytes from the input stream and converts to a 64-bit long integer.

Parameters:

in - Stream from which to read 8 bytes.

Returns:

Long integer value.

Throws:

StreamException - on stream IO errors.

toBytes

public static byte[] toBytes(int value)

Converts an integer into a 4-byte big endian array.

Parameters:

value - Integer value to convert.

Returns:

4-byte big-endian representation of integer value.

toBytes

public static void toBytes(int value,
                           byte[] output,
                           int offset)

Converts an integer into a 4-byte big endian array.

Parameters:

value - Integer value to convert.

output - Array into which bytes are placed.

offset - Offset into output array at which output bytes start.

toBytes

public static byte[] toBytes(long value)

Converts a long integer into an 8-byte big endian array.

Parameters:

value - Long integer value to convert.

Returns:

8-byte big-endian representation of long integer value.

toBytes

public static void toBytes(long value,
                           byte[] output,
                           int offset)

Converts an integer into a 8-byte big endian array.

Parameters:

value - Long value to convert.

output - Array into which bytes are placed.

offset - Offset into output array at which output bytes start.

toString

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

Converts a byte array into a string in the UTF-8 character set.

Parameters:

bytes - Byte array to convert.

Returns:

UTF-8 string representation of bytes.

toString

public static java.lang.String toString(java.nio.ByteBuffer buffer)

Converts a byte buffer into a string in the UTF-8 character set.

Parameters:

buffer - Byte buffer to convert.

Returns:

UTF-8 string representation of bytes.

toCharBuffer

public static java.nio.CharBuffer toCharBuffer(java.nio.ByteBuffer buffer)

Converts a byte buffer into a character buffer.

Parameters:

buffer - Byte buffer to convert.

Returns:

Character buffer containing UTF-8 string representation of bytes.

toByteBuffer

public static java.nio.ByteBuffer toByteBuffer(java.lang.String s)

Converts a string into bytes in the UTF-8 character set.

Parameters:

s - String to convert.

Returns:

Byte buffer containing byte representation of string.

toBytes

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

Converts a string into bytes in the UTF-8 character set.

Parameters:

s - String to convert.

Returns:

Byte array containing byte representation of string.

toArray

public static byte[] toArray(java.nio.ByteBuffer buffer)

Converts a byte buffer into a byte array.

Parameters:

buffer - Byte buffer to convert.

Returns:

Byte array corresponding to bytes of buffer from current position to limit.