CKTIS / Java
DataOutputStream — binaire gegevens schrijven
DataOutputStream schrijft primitieve waarden en tekenreeksen in een vastgelegd formaat naar een binaire stroom. Leer meer over de gegevensbreedtes, bytevolgorde en beperkingen van writeUTF.
Versie: 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 uit java.io wikkelt een OutputStream in en schrijft binaire gegevens in plaats van tekstuele weergaven. Lezen met DataInputStream moet overeenkomen met de volgorde en typen van de geschreven waarden.
DataOutputStream.writeByte(int) schrijft alleen de 8 minst significante bits: 257 levert de byte 0x01 op, zonder bereikcontrole. DataOutputStream.writeInt(int) schrijft 4 bytes in big-endian-volgorde, met de meest significante byte voorop. DataOutputStream.writeDouble(double) schrijft 8 bytes in dezelfde volgorde, na omzetting via Double.doubleToLongBits.
DataOutputStream.writeUTF(String) schrijft een lengte van twee bytes voor de gegevens, uitgedrukt in bytes, gevolgd door gewijzigde UTF-8. Dit is geen gewone UTF-8: NUL neemt 2 bytes in beslag en tekens buiten het Basic Multilingual Plane worden gecodeerd als surrogaatparen. De limiet is 65535 bytes aan gecodeerde gegevens, niet tekens; overschrijding veroorzaakt UTFDataFormatException.
Schrijfmethoden kunnen IOException veroorzaken. Het delen van de stroom tussen threads vereist synchronisatie. Het voorbeeld toont de verwachte 17 bytes in hexadecimale notatie. De documentatie betreft Java SE 21; noch de runtime van de repository, noch de productie-runtime is bevestigd.
Voorbeelden
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()));
}
}Resultaat
010000002a3ff800000000000000024f4b
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.