loci.poi.util

Class HexDump

java.lang.Object

loci.poi.util.HexDump

public class HexDump
extends Object

dump data in hexadecimal format; derived from a HexDump utility I wrote in June 2001.

Author:

Marc Johnson, Glen Stampoultzis (glens at apache.org)

Field Summary

Fields

Modifier and Type	Field and Description
private static char[]	_hexcodes
private static int[]	_shifts
static String	EOL

Constructor Summary

Constructors

Modifier	Constructor and Description
private	HexDump()

Method Summary

Methods

Modifier and Type	Method and Description
private static String	dump(byte value)
static String	dump(byte[] data, long offset, int index) dump an array of bytes to a String
static void	dump(byte[] data, long offset, OutputStream stream, int index) dump an array of bytes to an OutputStream
static void	dump(byte[] data, long offset, OutputStream stream, int index, int length) dump an array of bytes to an OutputStream
static void	dump(InputStream in, PrintStream out, int start, int bytesToDump) Dumps bytesToDump bytes to an output stream.
private static String	dump(long value)
static void	main(String[] args)
static String	toHex(byte value) Converts the parameter to a hex value.
static String	toHex(byte[] value) Converts the parameter to a hex value.
static String	toHex(byte[] value, int bytesPerLine) Converts the parameter to a hex value breaking the results into lines.
static String	toHex(int value) Converts the parameter to a hex value.
static String	toHex(long value) Converts the parameter to a hex value.
private static String	toHex(long value, int digits)
static String	toHex(short value) Converts the parameter to a hex value.
static String	toHex(short[] value) Converts the parameter to a hex value.

Methods inherited from class java.lang.Object

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

Field Detail

EOL

public static final String EOL

_hexcodes

private static final char[] _hexcodes

_shifts

private static final int[] _shifts

Constructor Detail

HexDump

private HexDump()

Method Detail

dump

public static void dump(byte[] data,
        long offset,
        OutputStream stream,
        int index,
        int length)
                 throws IOException,
                        ArrayIndexOutOfBoundsException,
                        IllegalArgumentException

dump an array of bytes to an OutputStream

Parameters:

data - the byte array to be dumped

offset - its offset, whatever that might mean

stream - the OutputStream to which the data is to be written

index - initial index into the byte array

length - number of characters to output

Throws:

IOException - is thrown if anything goes wrong writing the data to stream

ArrayIndexOutOfBoundsException - if the index is outside the data array's bounds

IllegalArgumentException - if the output stream is null

dump

public static void dump(byte[] data,
        long offset,
        OutputStream stream,
        int index)
                 throws IOException,
                        ArrayIndexOutOfBoundsException,
                        IllegalArgumentException

dump an array of bytes to an OutputStream

Parameters:

data - the byte array to be dumped

offset - its offset, whatever that might mean

stream - the OutputStream to which the data is to be written

index - initial index into the byte array

Throws:

IOException - is thrown if anything goes wrong writing the data to stream

ArrayIndexOutOfBoundsException - if the index is outside the data array's bounds

IllegalArgumentException - if the output stream is null

dump

public static String dump(byte[] data,
          long offset,
          int index)

dump an array of bytes to a String

Parameters:

data - the byte array to be dumped

offset - its offset, whatever that might mean

index - initial index into the byte array

Returns:

output string

Throws:

ArrayIndexOutOfBoundsException - if the index is outside the data array's bounds

dump

private static String dump(long value)

dump

private static String dump(byte value)

toHex

public static String toHex(byte[] value)

Converts the parameter to a hex value.

Parameters:

value - The value to convert

Returns:

A String representing the array of bytes

toHex

public static String toHex(short[] value)

Converts the parameter to a hex value.

Parameters:

value - The value to convert

Returns:

A String representing the array of shorts

toHex

public static String toHex(byte[] value,
           int bytesPerLine)

Converts the parameter to a hex value breaking the results into lines.

Parameters:

value - The value to convert

bytesPerLine - The maximum number of bytes per line. The next byte will be written to a new line

Returns:

A String representing the array of bytes

toHex

public static String toHex(short value)

Converts the parameter to a hex value.

Parameters:

value - The value to convert

Returns:

The result right padded with 0

toHex

public static String toHex(byte value)

Converts the parameter to a hex value.

Parameters:

value - The value to convert

Returns:

The result right padded with 0

toHex

public static String toHex(int value)

Converts the parameter to a hex value.

Parameters:

value - The value to convert

Returns:

The result right padded with 0

toHex

public static String toHex(long value)

Converts the parameter to a hex value.

Parameters:

value - The value to convert

Returns:

The result right padded with 0

toHex

private static String toHex(long value,
           int digits)

dump

public static void dump(InputStream in,
        PrintStream out,
        int start,
        int bytesToDump)
                 throws IOException

Dumps bytesToDump bytes to an output stream.

Parameters:

in - The stream to read from

out - The output stream

start - The index to use as the starting position for the left hand side label

bytesToDump - The number of bytes to output. Use -1 to read until the end of file.

Throws:

IOException

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception