CKTIS / Java
DataOutputStream — binarny zapis danych
DataOutputStream zapisuje wartości typów prostych i napisy do strumienia binarnego w określonym formacie. Poznaj rozmiary danych, kolejność bajtów oraz ograniczenia writeUTF.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
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 opakowuje OutputStream i zapisuje dane binarne, a nie ich tekstową reprezentację. Odczyt przez DataInputStream musi odpowiadać kolejności i typom zapisanych wartości.
DataOutputStream.writeByte(int) zapisuje tylko 8 najmłodszych bitów: 257 daje bajt 0x01, bez sprawdzania zakresu. DataOutputStream.writeInt(int) zapisuje 4 bajty w kolejności big-endian, czyli od najbardziej znaczącego. DataOutputStream.writeDouble(double) zapisuje 8 bajtów w tej samej kolejności, po konwersji przez Double.doubleToLongBits.
DataOutputStream.writeUTF(String) zapisuje dwubajtową długość danych w bajtach, a następnie zmodyfikowany UTF-8. To nie jest zwykły UTF-8: znak NUL zajmuje 2 bajty, a znaki spoza BMP są kodowane jako pary surogatów. Limit wynosi 65535 bajtów zakodowanego tekstu, nie znaków; przekroczenie powoduje UTFDataFormatException.
Metody zapisu mogą zgłosić IOException. Współdzielenie strumienia między wątkami wymaga synchronizacji. Przykład pokazuje oczekiwane 17 bajtów jako zapis szesnastkowy. Zakres dokumentacji to Java SE 21; środowisko repozytorium ani środowisko produkcyjne nie zostały potwierdzone.
Przykłady
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()));
}
}Wynik
010000002a3ff800000000000000024f4b
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.