CKTIS / Java
DataOutputStream — escritura de datos binarios
DataOutputStream escribe valores primitivos y cadenas en un flujo binario con un formato definido. Aprende los tamaños de los datos, el orden de los bytes y las limitaciones de writeUTF.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
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, de java.io, envuelve un OutputStream y escribe datos binarios en lugar de representaciones textuales. La lectura con DataInputStream debe respetar el orden y los tipos de los valores escritos.
DataOutputStream.writeByte(int) escribe solo los 8 bits menos significativos: 257 produce el byte 0x01, sin comprobar el rango. DataOutputStream.writeInt(int) escribe 4 bytes en orden big-endian, empezando por el más significativo. DataOutputStream.writeDouble(double) escribe 8 bytes en ese mismo orden, tras convertir el valor mediante Double.doubleToLongBits.
DataOutputStream.writeUTF(String) escribe una longitud de dos bytes para los datos, expresada en bytes, seguida de UTF-8 modificado. No es UTF-8 normal: NUL ocupa 2 bytes y los caracteres fuera del plano multilingüe básico se codifican como pares sustitutos. El límite es de 65535 bytes de datos codificados, no de caracteres; superarlo provoca UTFDataFormatException.
Los métodos de escritura pueden lanzar IOException. Compartir el flujo entre varios hilos requiere sincronización. El ejemplo muestra los 17 bytes esperados en formato hexadecimal. La documentación corresponde a Java SE 21; no se ha confirmado ni el entorno de ejecución del repositorio ni el de producción.
Ejemplos
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()));
}
}Resultado
010000002a3ff800000000000000024f4b
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.