## org.apache.poi.util
Class HexDump

    java.lang.Object
      org.apache.poi.util.HexDump

    public class HexDump

extends java.lang.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
`static java.lang.String` `EOL`

Method Summary
`static char[]` `byteToHex(int value)`
`static java.lang.String` `dump(byte[] data, long offset, int index)` dump an array of bytes to a String
`static void` `dump(byte[] data, long offset, java.io.OutputStream stream, int index)` dump an array of bytes to an OutputStream
`static void` `dump(byte[] data, long offset, java.io.OutputStream stream, int index, int length)` dump an array of bytes to an OutputStream
`static void` `dump(java.io.InputStream in, java.io.PrintStream out, int start, int bytesToDump)` Dumps `bytesToDump` bytes to an output stream.
`static char[]` `intToHex(int value)`
`static char[]` `longToHex(long value)`
`static void` `main(java.lang.String[] args)`
`static char[]` `shortToHex(int value)`
`static java.lang.String` `toHex(byte value)` Converts the parameter to a hex value.
`static java.lang.String` `toHex(byte[] value)` Converts the parameter to a hex value.
`static java.lang.String` `toHex(byte[] value, int bytesPerLine)` Converts the parameter to a hex value breaking the results into lines.
`static java.lang.String` `toHex(int value)` Converts the parameter to a hex value.
`static java.lang.String` `toHex(long value)` Converts the parameter to a hex value.
`static java.lang.String` `toHex(short value)` Converts the parameter to a hex value.
`static java.lang.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 java.lang.String EOL

Method Detail

### dump

    public static void dump(byte[] data,
                            long offset,
                            java.io.OutputStream stream,
                            int index,
                            int length)
                     throws java.io.IOException,
                            java.lang.ArrayIndexOutOfBoundsException,
                            java.lang.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:
    `java.io.IOException` - is thrown if anything goes wrong writing the data to stream
    `java.lang.ArrayIndexOutOfBoundsException` - if the index is outside the data array's bounds
    `java.lang.IllegalArgumentException` - if the output stream is null

### dump

    public static void dump(byte[] data,
                            long offset,
                            java.io.OutputStream stream,
                            int index)
                     throws java.io.IOException,
                            java.lang.ArrayIndexOutOfBoundsException,
                            java.lang.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:
    `java.io.IOException` - is thrown if anything goes wrong writing the data to stream
    `java.lang.ArrayIndexOutOfBoundsException` - if the index is outside the data array's bounds
    `java.lang.IllegalArgumentException` - if the output stream is null

### dump

    public static java.lang.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:
    `java.lang.ArrayIndexOutOfBoundsException` - if the index is outside the data array's bounds

### toHex

    public static java.lang.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 java.lang.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 java.lang.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 java.lang.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 java.lang.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 java.lang.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 java.lang.String toHex(long value)

  Converts the parameter to a hex value.

  Parameters:
    `value` - The value to convert
  Returns:
    The result right padded with 0

### dump

    public static void dump(java.io.InputStream in,
                            java.io.PrintStream out,
                            int start,
                            int bytesToDump)
                     throws java.io.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:
    `java.io.IOException`

### longToHex

    public static char[] longToHex(long value)

  Returns:
    char array of 4 (zero padded) uppercase hex chars and prefixed with '0x'

### intToHex

    public static char[] intToHex(int value)

  Returns:
    char array of 4 (zero padded) uppercase hex chars and prefixed with '0x'

### shortToHex

    public static char[] shortToHex(int value)

  Returns:
    char array of 2 (zero padded) uppercase hex chars and prefixed with '0x'

### byteToHex

    public static char[] byteToHex(int value)

  Returns:
    char array of 1 (zero padded) uppercase hex chars and prefixed with '0x'

### main

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

  Throws:
    `java.lang.Exception`

Copyright 2012 The Apache Software Foundation or its licensors, as applicable.