Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

DataOutputStream — zápis binárnych údajov

DataOutputStream zapisuje primitívne hodnoty a reťazce do binárneho prúdu v definovanom formáte. Zistite viac o veľkosti údajov, poradí bajtov a obmedzeniach metódy writeUTF.

Verzia: 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 z java.io obaľuje OutputStream a zapisuje binárne údaje, nie ich textové reprezentácie. Čítanie pomocou DataInputStream musí zodpovedať poradiu a typom zapísaných hodnôt.

DataOutputStream.writeByte(int) zapisuje iba 8 najnižších bitov: 257 vytvorí bajt 0x01 bez kontroly rozsahu. DataOutputStream.writeInt(int) zapisuje 4 bajty v poradí big-endian, teda od najvýznamnejšieho. DataOutputStream.writeDouble(double) zapisuje 8 bajtov v rovnakom poradí po konverzii pomocou Double.doubleToLongBits.

DataOutputStream.writeUTF(String) zapíše dvojbajtovú dĺžku údajov v bajtoch a potom modifikované UTF-8. Nejde o bežné UTF-8: NUL zaberá 2 bajty a znaky mimo základnej viacjazyčnej roviny sa kódujú ako páry náhradných znakov. Limit je 65535 bajtov zakódovaných údajov, nie znakov; jeho prekročenie spôsobí UTFDataFormatException.

Zapisovacie metódy môžu vyvolať IOException. Zdieľanie prúdu medzi vláknami vyžaduje synchronizáciu. Príklad zobrazuje očakávaných 17 bajtov v šestnástkovej sústave. Dokumentácia sa vzťahuje na Java SE 21; behové prostredie repozitára ani produkčné prostredie nebolo potvrdené.

Prí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ýsledok

010000002a3ff800000000000000024f4b

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje