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