CKTIS / Java
DataInputStream — getypeerde binaire gegevens lezen
DataInputStream leest primitieve waarden en tekenreeksen uit een binaire stream. Je moet de volgorde en codering van de velden kennen; getallen die als tekst zijn opgeslagen, worden hiermee niet geparseerd.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
new DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOExceptionDataInputStream uit java.io wikkelt een InputStream in en leest binaire gegevens in een machineonafhankelijk formaat. De gelezen typen en hun volgorde moeten overeenkomen met de gegevensindeling, bijvoorbeeld met waarden die door DataOutputStream zijn geschreven. De stream herkent veldtypen niet automatisch.
DataInputStream.readByte() verbruikt één byte en retourneert een byte met teken, van -128 tot 127. DataInputStream.readInt() verbruikt vier bytes en retourneert een 32-bits int met teken. DataInputStream.readDouble() verbruikt acht bytes die een double-waarde in IEEE 754-formaat voorstellen. Waarden die uit meerdere bytes bestaan, worden in big-endian-volgorde gelezen: de byte met de hoogste waarde eerst.
DataInputStream.readUTF() retourneert een String: eerst leest de methode een lengte van twee bytes zonder teken, daarna het opgegeven aantal bytes in aangepaste UTF-8. De lengte telt bytes, geen tekens, en is maximaal 65535. Dit is geen reader voor gewone UTF-8-bestanden; de indeling komt overeen met writeUTF().
Deze methoden geven een EOFException als er onvoldoende bytes zijn om een waarde te lezen, in plaats van een eindmarkering te retourneren. Andere invoer-/uitvoerfouten veroorzaken een IOException; een ongeldige tekenreeks codering kan een UTFDataFormatException veroorzaken. Gelijktijdige toegang vereist externe synchronisatie.
Voorbeelden
import java.io.ByteArrayInputStream;
import java.io.DataInputStream;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
byte[] data = {
-7,
0, 0, 0, 42,
0x40, 0x0C, 0, 0, 0, 0, 0, 0,
0, 2, 0x4F, 0x4B
};
try (DataInputStream in = new DataInputStream(
new ByteArrayInputStream(data))) {
System.out.println(in.readByte());
System.out.println(in.readInt());
System.out.println(in.readDouble());
System.out.println(in.readUTF());
}
}
}Resultaat
-7 42 3.5 OK
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.