Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

DataOutputStream — zápis binárních dat

DataOutputStream zapisuje primitivní hodnoty a řetězce do binárního proudu v definovaném formátu. Seznamte se s velikostí dat, pořadím bajtů a omezeními metody writeUTF.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

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 z java.io obaluje OutputStream a zapisuje binární data, nikoli jejich textové reprezentace. Čtení pomocí DataInputStream musí odpovídat pořadí a typům zapsaných hodnot.

DataOutputStream.writeByte(int) zapisuje pouze 8 nejnižších bitů: 257 vytvoří bajt 0x01, aniž by se kontroloval rozsah. DataOutputStream.writeInt(int) zapisuje 4 bajty v pořadí big-endian, tedy od nejvýznamnějšího. DataOutputStream.writeDouble(double) zapisuje 8 bajtů ve stejném pořadí po převodu pomocí Double.doubleToLongBits.

DataOutputStream.writeUTF(String) zapíše dvoubajtovou délku dat v bajtech a poté modifikované UTF-8. Nejde o běžné UTF-8: NUL zabírá 2 bajty a znaky mimo základní vícejazyčnou rovinu se kódují jako páry náhradních znaků. Limit je 65535 bajtů zakódovaných dat, nikoli znaků; jeho překročení způsobí UTFDataFormatException.

Zapisovací metody mohou vyvolat IOException. Sdílení proudu mezi vlákny vyžaduje synchronizaci. Příklad zobrazuje očekávaných 17 bajtů v šestnáctkové soustavě. Dokumentace se vztahuje k Java SE 21; běhové prostředí repozitáře ani produkční prostředí nebylo potvrzeno.

Příklady

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()));
    }
}

Výsledek

010000002a3ff800000000000000024f4b

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje