WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 IOException

DataOutputStream 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.

Quellen