CKTIS / Java
DataInputStream — odczyt typowanych danych binarnych
DataInputStream odczytuje wartości typów prostych i napisy ze strumienia binarnego. Wymaga znajomości kolejności pól oraz ich kodowania; nie służy do parsowania liczb zapisanych jako tekst.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
new DataInputStream(InputStream in)
byte readByte() throws IOException
int readInt() throws IOException
double readDouble() throws IOException
String readUTF() throws IOExceptionDataInputStream z pakietu java.io opakowuje InputStream i odczytuje dane binarne w formacie niezależnym od maszyny. Typy i kolejność odczytów muszą odpowiadać formatowi danych, na przykład wartościom zapisanym przez DataOutputStream. Strumień nie rozpoznaje sam typów pól.
DataInputStream.readByte() zużywa jeden bajt i zwraca byte ze znakiem, od -128 do 127. DataInputStream.readInt() zużywa cztery bajty i zwraca 32-bitowy int ze znakiem. DataInputStream.readDouble() zużywa osiem bajtów reprezentujących wartość double w formacie IEEE 754. Wartości wielobajtowe są odczytywane w kolejności big-endian: najstarszy bajt jako pierwszy.
DataInputStream.readUTF() zwraca String: najpierw odczytuje dwubajtową długość bez znaku, następnie wskazaną liczbę bajtów w zmodyfikowanym UTF-8. Długość oznacza bajty, nie znaki, i wynosi najwyżej 65535. Nie jest to czytnik zwykłego pliku UTF-8; format odpowiada writeUTF().
Te metody zgłaszają EOFException, gdy brakuje bajtów potrzebnych do odczytu wartości, zamiast zwracać znacznik końca. Inne błędy wejścia/wyjścia powodują IOException, a niepoprawne kodowanie napisu może spowodować UTFDataFormatException. Współbieżny dostęp wymaga zewnętrznej synchronizacji.
Przykłady
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());
}
}
}Wynik
-7 42 3.5 OK
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.