home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 October / Chip_1997-10_cd.bin / tema / sybase / powerj / java.z / DataInput.java < prev    next >
Text File  |  1996-05-03  |  5KB  |  144 lines
  1. /*
  2.  * @(#)DataInput.java    1.6 95/12/18 Arthur van Hoff
  3.  *
  4.  * Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software
  7.  * and its documentation for NON-COMMERCIAL purposes and without
  8.  * fee is hereby granted provided that this copyright notice
  9.  * appears in all copies. Please refer to the file "copyright.html"
  10.  * for further important copyright and licensing information.
  11.  *
  12.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  13.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  14.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  15.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  16.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  17.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  18.  */
  19.  
  20. package java.io;
  21.  
  22. /**
  23.  * DataInput is an interface describing streams that can read input
  24.  * in a machine-independent format.
  25.  *
  26.  * @see DataInputStream
  27.  * @see DataOutput
  28.  * @version     1.6, 18 Dec 1995
  29.  * @author    Frank Yellin
  30.  */
  31. public
  32. interface DataInput {
  33.     /**
  34.      * Reads bytes, blocking until all bytes are read.
  35.      * @param b    the buffer into which the data is read
  36.      * @exception EOFException If end of file is reached.
  37.      * @exception IOException If other I/O error has occurred.
  38.      */
  39.     void readFully(byte b[]) throws IOException;
  40.  
  41.     /**
  42.      * Reads bytes, blocking until all bytes are read.
  43.      * @param b    the buffer into which the data is read
  44.      * @param off the start offset of the data
  45.      * @param len the maximum number of bytes to read
  46.      * @exception EOFException If end of file is reached.
  47.      * @exception IOException If other I/O error has occurred.
  48.      */
  49.     void readFully(byte b[], int off, int len) throws IOException;
  50.  
  51.     /**
  52.      * Skips bytes, block until all bytes are skipped.
  53.      * @param n the number of bytes to be skipped
  54.      * @return    the actual number of bytes skipped.
  55.      * @exception EOFException If end of file is reached.
  56.      * @exception IOException If other I/O error has occurred.
  57.      */
  58.     int skipBytes(int n) throws IOException;
  59.  
  60.     /**
  61.      * Reads in a boolean.
  62.      * @return the boolean read.
  63.      * @exception EOFException If end of file is reached.
  64.      * @exception IOException If other I/O error has occurred.
  65.      */
  66.     boolean readBoolean() throws IOException;
  67.  
  68.     /**
  69.      * Reads an 8 bit byte.
  70.      * @return the 8 bit byte read.
  71.      * @exception EOFException If end of file is reached.
  72.      * @exception IOException If other I/O error has occurred.
  73.      */
  74.     byte readByte() throws IOException;
  75.  
  76.     /**
  77.      * Reads an unsigned 8 bit byte.
  78.      * @return the 8 bit byte read.
  79.      * @exception EOFException If end of file is reached.
  80.      * @exception IOException If other I/O error has occurred.
  81.      */
  82.     int readUnsignedByte() throws IOException;
  83.  
  84.     /**
  85.      * Reads a 16 bit short.
  86.      * @return the 16 bit short read.
  87.      * @exception EOFException If end of file is reached.
  88.      * @exception IOException If other I/O error has occurred.
  89.      */
  90.     short readShort() throws IOException;
  91.  
  92.     /**
  93.      * Reads an unsigned 16 bit short.
  94.      * @return the 16 bit short read.
  95.      * @exception EOFException If end of file is reached.
  96.      * @exception IOException If other I/O error has occurred.
  97.      */
  98.     int readUnsignedShort() throws IOException;
  99.  
  100.     /**
  101.      * Reads a 16 bit char.
  102.      * @return the 16 bit char read. 
  103.      * @exception EOFException If end of file is reached.
  104.      * @exception IOException If other I/O error has occurred.
  105.      */
  106.     char readChar() throws IOException;
  107.  
  108.     /**
  109.      * Reads a 32 bit int.
  110.      * @return the 32 bit integer read.
  111.      * @exception EOFException If end of file is reached.
  112.      * @exception IOException If other I/O error has occurred.
  113.      */
  114.     int readInt() throws IOException;
  115.  
  116.     /**
  117.      * Reads a 64 bit long.
  118.      * @return the read 64 bit long.
  119.      * @exception EOFException If end of file is reached.
  120.      * @exception IOException If other I/O error has occurred.
  121.      */
  122.     long readLong() throws IOException;
  123.  
  124.     /**
  125.      * Reads a 32 bit float.
  126.      * @return the 32 bit float read.
  127.      * @exception EOFException If end of file is reached.
  128.      * @exception IOException If other I/O error has occurred.
  129.      */
  130.     float readFloat() throws IOException;
  131.  
  132.     /**
  133.      * Reads a 64 bit double.
  134.      * @return the 64 bit double read.
  135.      * @exception EOFException If end of file is reached.
  136.      * @exception IOException If other I/O error has occurred.
  137.      */
  138.     double readDouble() throws IOException;
  139.  
  140.     String readLine() throws IOException;
  141.  
  142.     String readUTF() throws IOException;
  143. }
  144.