Class java.io.FileInputStream
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.io.FileInputStream

java.lang.Object
   |
   +----java.io.InputStream
           |
           +----java.io.FileInputStream

public class FileInputStream
extends InputStream
File input stream, can be constructed from a file descriptor or a file name.
See Also:
FileOutputStream, File

Constructor Index

 o FileInputStream(String)
Creates an input file with the specified system dependent file name.
 o FileInputStream(File)
Creates an input file from the specified File object.
 o FileInputStream(FileDescriptor)

Method Index

 o available()
Returns the number of bytes that can be read without blocking.
 o close()
Closes the input stream.
 o finalize()
Closes the stream when garbage is collected.
 o getFD()
Returns the opaque file descriptor object associated with this stream.
 o read()
Reads a byte of data.
 o read(byte[])
Reads data into an array of bytes.
 o read(byte[], int, int)
Reads data into an array of bytes.
 o skip(long)
Skips n bytes of input.

Constructors

 o FileInputStream
  public FileInputStream(String name) throws FileNotFoundException
Creates an input file with the specified system dependent file name.
Parameters:
name - the system dependent file name
Throws: IOException
If the file is not found.
 o FileInputStream
  public FileInputStream(File file) throws FileNotFoundException
Creates an input file from the specified File object.
Parameters:
file - the file to be opened for reading
Throws: IOException
If the file is not found.
 o FileInputStream
  public FileInputStream(FileDescriptor fdObj)

Methods

 o read
  public int read() throws IOException
Reads a byte of data. This method will block if no input is available.
Returns:
the byte read, or -1 if the end of the stream is reached.
Throws: IOException
If an I/O error has occurred.
Overrides:
read in class InputStream
 o read
  public int read(byte b[]) throws IOException
Reads data into an array of bytes. This method blocks until some input is available.
Parameters:
b - the buffer into which the data is read
Returns:
the actual number of bytes read. -1 is returned if the end of stream is reached.
Throws: IOException
If an I/O error has occurred.
Overrides:
read in class InputStream
 o read
  public int read(byte b[],
                  int off,
                  int len) throws IOException
Reads data into an array of bytes. This method blocks until some input is available.
Parameters:
b - the buffer into which the data is read
off - the start offset of the data
len - the maximum number of bytes read
Returns:
the actual number of bytes read. -1 is returned when the end of the stream is reached.
Throws: IOException
If an I/O error has occurred.
Overrides:
read in class InputStream
 o skip
  public long skip(long n) throws IOException
Skips n bytes of input.
Parameters:
n - the number of bytes to be skipped
Returns:
the actual number of bytes skipped.
Throws: IOException
If an I/O error has occurred.
Overrides:
skip in class InputStream
 o available
  public int available() throws IOException
Returns the number of bytes that can be read without blocking.
Returns:
the number of available bytes, which is initially equal to the file size.
Overrides:
available in class InputStream
 o close
  public void close() throws IOException
Closes the input stream. This method must be called to release any resources associated with the stream.
Throws: IOException
If an I/O error has occurred.
Overrides:
close in class InputStream
 o getFD
  public final FileDescriptor getFD() throws IOException
Returns the opaque file descriptor object associated with this stream.
Returns:
the file descriptor.
 o finalize
  protected void finalize() throws IOException
Closes the stream when garbage is collected.
Overrides:
finalize in class Object

All Packages  Class Hierarchy  This Package  Previous  Next  Index