Weitere aktuelle Java-Titel finden Sie bei dpunkt.
 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index
Klasse java.io.DataInputStream1.0

java.lang.Object
   |
   +--java.io.InputStream
         |
         +--java.io.FilterInputStream
               |
               +--java.io.DataInputStream

Deklaration

public class DataInputStream
extends java.io.FilterInputStream
implements java.io.DataInput

Beschreibung

DataInputStream implementiert das Interface DataInput und stellt Routinen zur Verfügung, mit denen Werte der Standarddatentypen aus einem Stream gelesen werden können.

 
Konstruktoren
publicDataInputStream(InputStream in)
 
Methoden
public final intread(byte[] b)
public final intread(byte[] b, int off, int len)
public final booleanreadBoolean()
public final bytereadByte()
public final charreadChar()
public final doublereadDouble()
public final floatreadFloat()
public final voidreadFully(byte[] b)
public final voidreadFully(byte[] b, int off, int len)
public final intreadInt()
public final StringreadLine()
      Verworfen in Version 1.2.
public final longreadLong()
public final shortreadShort()
public final intreadUnsignedByte()
public final intreadUnsignedShort()
public final StringreadUTF()
public final static StringreadUTF(DataInput in)
public final intskipBytes(int n)

 

Konstruktoren im Detail

public DataInputStream(InputStream in)
Erzeugt einen neuen DataInputStream, der die Daten aus dem Stream in liest.

 

Methoden im Detail

public final int read(byte[] b)
Versucht, b.length() Bytes aus dem Stream zu lesen, und speichert sie in b. Wenn beim Versuch, das erste Byte zu lesen, das Dateiende bereits erreicht ist, ist der Rückgabewert -1, ansonsten wird die Anzahl der tatsächlich gelesenen Bytes zurückgeliefert. Wenn der Stream momentan leer ist, wartet read, bis wieder mindestens ein Byte gelesen werden kann.
Exception: IOException
public final int read(byte[] b, int off, int len)
Versucht, len Bytes aus dem Stream zu lesen und speichert sie ab dem Index off in b. Wenn beim Versuch, das erste Byte zu lesen, das Stream-Ende bereits erreicht war, ist der Rückgabewert -1, ansonsten wird die Anzahl der tatsächlich gelesenen Bytes zurückgeliefert. Wenn während des Lesevorgangs das Stream-Ende erreicht wird oder wenn im darunterliegenden Stream nur weniger als len Bytes gelesen werden können, ohne zu blockieren, kehrt die Methode zurück und liefert die Anzahl der bis dahin gelesenen Bytes.
Exception: IOException
public final boolean readBoolean()
Liest 1 Byte aus dem Stream und liefert false, wenn dieses Byte den Wert null hat, sonst true.
Exception: IOException
Exception: EOFException
public final byte readByte()
Liest 1 Byte aus dem Stream und liefert es zurück.
Exception: IOException
Exception: EOFException
public final char readChar()
Liest ein Unicode-Zeichen (2 Bytes) aus dem Stream und liefert es zurück. Das zuerst gelesene Byte wird zum höherwertigen Byte des gelieferten Zeichens, das zweite zum niederwertigen.
Exception: IOException
Exception: EOFException
public final double readDouble()
Liest einen double-Wert (8 Bytes) aus dem Stream und liefert ihn zurück. Hierbei wird zunächst ein long-Wert gelesen, der dann mit Double.longBitsToDouble() konvertiert wird.
Exception: IOException
Exception: EOFException
public final float readFloat()
Liest einen float-Wert (4 Bytes) aus dem Stream und liefert ihn zurück. Hierbei wird zunächst ein int-Wert gelesen, der dann mit Float.intBitsToFloat() konvertiert wird.
Exception: IOException
Exception: EOFException
public final void readFully(byte[] b)
Füllt den Puffer b bis zur vollen Länge mit den nächsten Zeichen aus dem Stream. Diese Methode blockiert so lange, bis b.length Bytes gelesen wurden oder vorzeitig das Ende des Streams auftritt.
Exception: IOException
Exception: EOFException
public final void readFully(byte[] b, int off, int len)
Liest len Bytes aus dem Stream und speichert sie ab dem Index off im Puffer b. Diese Methode blockiert so lange, bis len Bytes gelesen wurden oder vorzeitig das Ende des Streams auftritt.
Exception: IOException
Exception: EOFException
public final int readInt()
Liest einen int-Wert (4 Bytes) aus dem Stream und liefert ihn zurück. Das höchstwertige Byte wird zuerst, das niederwertigste zuletzt gelesen.
Exception: IOException
Exception: EOFException
public final String readLine()
Liest eine Textzeile aus dem Stream. Als Zeilenende-Sequenz wird '\r', '\n' oder "\r\n" akzeptiert. Diese Methode faßt jedes einzelne gelesene Byte als Zeichen auf, wobei keine Konvertierung aus dem Zeichensatz der Plattform vorgenommen wird. Das höherwertige Byte der Unicode-Zeichen im Ergebnis-String ist stets null.
Exception: IOException
Exception: EOFException
public final long readLong()
Liest einen long-Wert (8 Bytes) aus dem Stream und liefert ihn zurück. Das höchstwertige Byte wird zuerst, das niederwertigste zuletzt gelesen.
Exception: IOException
Exception: EOFException
public final short readShort()
Liest einen short-Wert aus dem Stream.
Exception: IOException
Exception: EOFException
public final int readUnsignedByte()
Liest ein als vorzeichenlos interpretiertes Byte aus dem Stream und liefert es als int-Wert zurück.
Exception: IOException
Exception: EOFException
public final int readUnsignedShort()
Liest zwei als vorzeichenlos interpretierte Bytes aus dem Stream und liefert sie als int-Wert zurück.
Exception: IOException
Exception: EOFException
public final String readUTF()
Liest einen UTF-codierten String aus dem Stream und liefert ihn zurück. Hierbei werden jeweils bis zu 3 Bytes pro Zeichen aus dem Stream gelesen und gemäß der UTF-Codierung in eine Kette von 16-Bit-Unicode-Zeichen transformiert, aus denen der Ergebnis-String aufgebaut wird.
Exception: IOException
Exception: EOFException
public final static String readUTF(DataInput in)
Diese Methode ist statisch und liest einen UTF-codierten String aus dem Stream in und liefert ihn zurück. Hierbei werden jeweils bis zu drei Bytes pro Zeichen aus dem Stream gelesen und gemäß der UTF-Codierung in eine Kette von 16-Bit-Unicode-Zeichen transformiert, aus denen der Ergebnis-String aufgebaut wird.
Exception: IOException
Exception: EOFException
public final int skipBytes(int n)
Versucht, n Bytes aus dem Stream zu überlesen, und liefert die Anzahl der tatsächlich übersrungenen Bytes. Diese kann kleiner als n sein, wenn vorzeitig das Ende des Streams erreicht wird. Fall momentan weniger als n Bytes im Stream bereitstehen, blockiert diese Methode so lange, bis n Bytes gelesen werden konnten oder das Stream-Ende erreicht ist.
Exception: IOException
Exception: EOFException

 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index
Copyright © 2002 dpunkt.Verlag, Heidelberg. Alle Rechte vorbehalten.