CKTIS / Java
DataOutputStream — Binärdaten schreiben
DataOutputStream schreibt primitive Werte und Zeichenfolgen in einem festgelegten Format in einen Binärdatenstrom. Lerne die Datenbreiten, die Byte-Reihenfolge und die Einschränkungen von writeUTF kennen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
new DataOutputStream(OutputStream out)
void writeByte(int v) throws IOException
void writeInt(int v) throws IOException
void writeDouble(double v) throws IOException
void writeUTF(String str) throws IOExceptionDataOutputStream aus java.io umschließt einen OutputStream und schreibt Binärdaten statt textueller Darstellungen. Beim Lesen mit DataInputStream müssen Reihenfolge und Typen der geschriebenen Werte übereinstimmen.
DataOutputStream.writeByte(int) schreibt nur die niederwertigsten 8 Bits: 257 ergibt das Byte 0x01, ohne dass der Wertebereich geprüft wird. DataOutputStream.writeInt(int) schreibt 4 Bytes in Big-Endian-Reihenfolge, also mit dem höchstwertigen Byte zuerst. DataOutputStream.writeDouble(double) schreibt nach der Umwandlung über Double.doubleToLongBits 8 Bytes in derselben Reihenfolge.
DataOutputStream.writeUTF(String) schreibt eine zweibyte lange Nutzdatenlänge in Bytes und danach modifiziertes UTF-8. Das ist nicht gewöhnliches UTF-8: NUL benötigt 2 Bytes, und Zeichen außerhalb der Basic Multilingual Plane werden als Surrogatpaare codiert. Die Grenze liegt bei 65535 codierten Nutzdatenbytes, nicht bei Zeichen; bei Überschreitung wird UTFDataFormatException ausgelöst.
Schreibmethoden können IOException auslösen. Wenn mehrere Threads denselben Datenstrom verwenden, ist Synchronisierung erforderlich. Das Beispiel zeigt die erwarteten 17 Bytes in hexadezimaler Schreibweise. Die Dokumentation bezieht sich auf Java SE 21; weder die Laufzeitumgebung des Repositorys noch die Produktionsumgebung wurde bestätigt.
Beispiele
import java.io.ByteArrayOutputStream;
import java.io.DataOutputStream;
import java.io.IOException;
import java.util.HexFormat;
public class Main {
public static void main(String[] args) throws IOException {
ByteArrayOutputStream bytes = new ByteArrayOutputStream();
try (DataOutputStream out = new DataOutputStream(bytes)) {
out.writeByte(257);
out.writeInt(42);
out.writeDouble(1.5);
out.writeUTF("OK");
}
System.out.println(HexFormat.of().formatHex(bytes.toByteArray()));
}
}Ergebnis
010000002a3ff800000000000000024f4b
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.