CKTIS / Java
DataInputStream — typisierte Binärdaten lesen
DataInputStream liest primitive Werte und Zeichenketten aus einem Binärdatenstrom. Die Reihenfolge und Kodierung der Felder müssen bekannt sein; Zahlen, die als Text gespeichert sind, werden damit nicht geparst.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
new DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOExceptionDataInputStream aus java.io umschließt einen InputStream und liest Binärdaten in einem maschinenunabhängigen Format. Die gelesenen Typen und ihre Reihenfolge müssen dem Datenformat entsprechen, zum Beispiel den von DataOutputStream geschriebenen Werten. Der Stream erkennt Feldtypen nicht selbstständig.
DataInputStream.readByte() verbraucht ein Byte und gibt einen vorzeichenbehafteten byte-Wert von -128 bis 127 zurück. DataInputStream.readInt() verbraucht vier Bytes und gibt einen vorzeichenbehafteten 32-Bit-int zurück. DataInputStream.readDouble() verbraucht acht Bytes, die einen double-Wert im IEEE-754-Format darstellen. Mehrbytewerte werden in Big-Endian-Reihenfolge gelesen: zuerst das höchstwertige Byte.
DataInputStream.readUTF() gibt einen String zurück: Zuerst liest die Methode eine vorzeichenlose Länge von zwei Bytes, danach die angegebene Anzahl von Bytes in modifiziertem UTF-8. Die Länge zählt Bytes, keine Zeichen, und beträgt höchstens 65535. Dies ist kein Reader für gewöhnliche UTF-8-Dateien; das Format entspricht writeUTF().
Diese Methoden lösen eine EOFException aus, wenn nicht genügend Bytes zum Lesen eines Werts vorhanden sind, anstatt eine Endmarkierung zurückzugeben. Andere Ein-/Ausgabefehler führen zu einer IOException; eine ungültige Zeichenkodierung kann eine UTFDataFormatException auslösen. Gleichzeitiger Zugriff erfordert eine externe Synchronisierung.
Beispiele
import java.io.ByteArrayInputStream;
import java.io.DataInputStream;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
byte[] data = {
-7,
0, 0, 0, 42,
0x40, 0x0C, 0, 0, 0, 0, 0, 0,
0, 2, 0x4F, 0x4B
};
try (DataInputStream in = new DataInputStream(
new ByteArrayInputStream(data))) {
System.out.println(in.readByte());
System.out.println(in.readInt());
System.out.println(in.readDouble());
System.out.println(in.readUTF());
}
}
}Ergebnis
-7 42 3.5 OK
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.