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