Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

DataOutputStream — zapisivanje binarnih podataka

DataOutputStream zapisuje primitivne vrijednosti i nizove znakova u binarni tok u definiranom formatu. Saznajte više o veličinama podataka, redoslijedu bajtova i ograničenjima metode writeUTF.

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

Sintaksa

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 iz java.io omata OutputStream i zapisuje binarne podatke umjesto njihovih tekstualnih prikaza. Čitanje pomoću DataInputStream mora odgovarati redoslijedu i vrstama zapisanih vrijednosti.

DataOutputStream.writeByte(int) zapisuje samo 8 najnižih bitova argumenta: 257 daje bajt 0x01, bez provjere raspona. DataOutputStream.writeInt(int) zapisuje 4 bajta redoslijedom big-endian, počevši od najznačajnijeg. DataOutputStream.writeDouble(double) nakon pretvorbe pomoću Double.doubleToLongBits zapisuje 8 bajtova istim redoslijedom.

DataOutputStream.writeUTF(String) zapisuje duljinu podataka od dva bajta, izraženu u bajtovima, a zatim modificirani UTF-8. To nije obični UTF-8: NUL zauzima 2 bajta, a znakovi izvan osnovne višejezične ravnine kodiraju se kao zamjenski parovi. Ograničenje je 65535 bajtova kodiranih podataka, a ne znakova; prekoračenje uzrokuje UTFDataFormatException.

Metode zapisivanja mogu izbaciti IOException. Dijeljenje toka među dretvama zahtijeva sinkronizaciju. Primjer prikazuje očekivanih 17 bajtova u heksadekadskom zapisu. Dokumentacija se odnosi na Java SE 21; ni okruženje izvođenja u repozitoriju ni produkcijsko okruženje nije potvrđeno.

Primjeri

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

Rezultat

010000002a3ff800000000000000024f4b

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori