Package de.bsvrz.sys.funclib.hexdump
Class HexDumper
- java.lang.Object
-
- de.bsvrz.sys.funclib.hexdump.HexDumper
-
public class HexDumper extends java.lang.Object
Klasse zum Erzeugen von Hex-Dumps. Ein Hex-Dump enthält ein Darstellung der in einem Byte-Array enthaltenen Bytes. Beispiel:
Eine Zeile eines Hexdumps enthält die Darstellung von bis zu 16 Bytes des Byte-Arrays. Links wird die Adresse des ersten Bytes der Zeile dargestellt, in der Mitte werden die Bytes in Hexadezimaler Form und rechts in lesbarer Form dargestellt. Für die lesbare Darstellung wird die ISO-8859-1 Kodierung angenommen und nicht darstellbare Zeichen werden durch Punkte ersetzt.00000000: 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F !"#$%&'()*+,-./ 00000010: 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F 0123456789:;<=>? 00000020: 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F @ABCDEFGHIJKLMNO 00000030: 50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F PQRSTUVWXYZ[\]^_
-
-
Constructor Summary
Constructors Constructor Description HexDumper()
Erzeugt ein neues HexDumper-Objekt, das bei der Ausgabe überdump(...)
den PrintStreamSystem.out
benutzt.HexDumper(java.io.PrintStream out)
Erzeugt ein neues HexDumper-Objekt, das zur Ausgabe überdump(...)
das angegebene PrintStream-Objekt benutzt.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
dump(byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.void
dump(byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.void
dump(int baseAddress, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.void
dump(int baseAddress, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.static void
dumpTo(java.io.PrintStream out, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.static void
dumpTo(java.io.PrintStream out, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.static void
dumpTo(java.io.PrintStream out, int baseAddress, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.static void
dumpTo(java.io.PrintStream out, int baseAddress, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.static byte[]
toBytes(int[] ints)
Konvertiert ein Int-Array in ein Byte-Array.static java.lang.String
toString(byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump.static java.lang.String
toString(byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump.static java.lang.String
toString(int baseAddress, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump.static java.lang.String
toString(int baseAddress, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump.
-
-
-
Constructor Detail
-
HexDumper
public HexDumper()
Erzeugt ein neues HexDumper-Objekt, das bei der Ausgabe überdump(...)
den PrintStreamSystem.out
benutzt.
-
HexDumper
public HexDumper(java.io.PrintStream out)
Erzeugt ein neues HexDumper-Objekt, das zur Ausgabe überdump(...)
das angegebene PrintStream-Objekt benutzt.- Parameters:
out
- PrintStream-Objekt, das bei der Ausgabe mit den Funktionen
-
-
Method Detail
-
toString
public static java.lang.String toString(byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump.- Parameters:
bytes
- Array mit zu konvertierenden Bytes.- Returns:
- Hex-Dump
-
toString
public static java.lang.String toString(byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump.- Parameters:
bytes
- Array mit zu konvertierenden Bytes.startOffset
- Index des ersten zu konvertierenden Bytes im Array.count
- Anzahl der zu konvertierenden Bytes.- Returns:
- Hex-Dump
-
toString
public static java.lang.String toString(int baseAddress, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump.- Parameters:
baseAddress
- Offset für die Addressausgaben. Der angegebene Wert wird als Adresse des ersten Bytes im Byte-Array interpretiert.bytes
- Array mit zu konvertierenden Bytes.- Returns:
- Hex-Dump
-
toString
public static java.lang.String toString(int baseAddress, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump.- Parameters:
baseAddress
- Offset für die Addressausgaben. Der angegebene Wert wird als Adresse des ersten Bytes im Byte-Array interpretiert.bytes
- Array mit zu konvertierenden Bytes.startOffset
- Index des ersten zu konvertierenden Bytes im Array.count
- Anzahl der zu konvertierenden Bytes.- Returns:
- Hex-Dump
-
dumpTo
public static void dumpTo(java.io.PrintStream out, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.- Parameters:
out
- PrintStream der zur Ausgabe benutzt werden soll.bytes
- Array mit zu konvertierenden Bytes.
-
dumpTo
public static void dumpTo(java.io.PrintStream out, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.- Parameters:
out
- PrintStream der zur Ausgabe benutzt werden soll.bytes
- Array mit zu konvertierenden Bytes.startOffset
- Index des ersten zu konvertierenden Bytes im Array.count
- Anzahl der zu konvertierenden Bytes.
-
dumpTo
public static void dumpTo(java.io.PrintStream out, int baseAddress, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.- Parameters:
out
- PrintStream der zur Ausgabe benutzt werden soll.baseAddress
- Offset für die Addressausgaben. Der angegebene Wert wird als Adresse des ersten Bytes im Byte-Array interpretiert.bytes
- Array mit zu konvertierenden Bytes.
-
dumpTo
public static void dumpTo(java.io.PrintStream out, int baseAddress, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf einen PrintStream aus.- Parameters:
out
- PrintStream der zur Ausgabe benutzt werden soll.baseAddress
- Offset für die Addressausgaben. Der angegebene Wert wird als Adresse des ersten Bytes im Byte-Array interpretiert.bytes
- Array mit zu konvertierenden Bytes.startOffset
- Index des ersten zu konvertierenden Bytes im Array.count
- Anzahl der zu konvertierenden Bytes.
-
toBytes
public static byte[] toBytes(int[] ints)
Konvertiert ein Int-Array in ein Byte-Array. Dabei werden int-Werte zwischen 0 und 255 in entsprechende Werte eines Bytes konvertiert (0 bis 127 und -128 bis -1). Andere Werte führen zu einer RunTimeException- Parameters:
ints
- Zu konvertierendes int-Array mit Werten zwischen 0 und 255.- Returns:
- byte-Array mit entsprechenden Werten im Bereich 0 bis 127 und -128 bis -1.
- Throws:
java.lang.IllegalArgumentException
- Wenn im zu konvertierenden int-Array Werte außerhalb des Bereich 0-255 vorkommen.
-
dump
public void dump(byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.- Parameters:
bytes
- Array mit zu konvertierenden Bytes.
-
dump
public void dump(byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.- Parameters:
bytes
- Array mit zu konvertierenden Bytes.startOffset
- Index des ersten zu konvertierenden Bytes im Array.count
- Anzahl der zu konvertierenden Bytes.
-
dump
public void dump(int baseAddress, byte[] bytes)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.- Parameters:
baseAddress
- Offset für die Addressausgaben. Der angegebene Wert wird als Adresse des ersten Bytes im Byte-Array interpretiert.bytes
- Array mit zu konvertierenden Bytes.
-
dump
public void dump(int baseAddress, byte[] bytes, int startOffset, int count)
Konvertiert ein Byte-Array in ein Hex-Dump und gibt das Ergebnis auf den PrintStream aus, der diesem HexDumper-Objekt im Konstruktor zugeordnet wurde.- Parameters:
baseAddress
- Offset für die Addressausgaben. Der angegebene Wert wird als Adresse des ersten Bytes im Byte-Array interpretiert.bytes
- Array mit zu konvertierenden Bytes.startOffset
- Index des ersten zu konvertierenden Bytes im Array.count
- Anzahl der zu konvertierenden Bytes.
-
-