类 java.io.FileInputStream

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

public class FileInputStream

extends InputStream

文件输入流是一个从 File 或 FileDescriptor 读取数据的输入流。

来自：

JDK1.0

参见：

File, FileDescriptor, FileOutputStream

构造子索引

FileInputStream(File)

创建一个输入文件流，从指定的 File 对象读取数据。

FileInputStream(FileDescriptor)

创建一个输入文件流，从指定的文件描述器读取数据。

FileInputStream(String)

创建一个输入文件流，从指定名称的文件读取数据。

方法索引

available()

返回从当前文件输入流中可无阻塞读取的字节数。

close()

关闭当前文件输入流，并释放与它相关的任一系统资源。

finalize()

当这个文件输入流不再有引用时，确保调用它的 close 方法。

getFD()

返回与当前流相关的不透明的文件描述符。

read()

从当前输入流中读取一字节数据。

read(byte[])

将当前输入流中 b.length 个字节数据读到一个字节数组中。

read(byte[], int, int)

将输入流中 len 个字节数据读入一个字节数组中。

skip(long)

跳过并删除输入流中的 n 字节数据。

构造子

 public FileInputStream(String name) throws FileNotFoundException

创建一个输入文件流，从指定名称的文件读取数据。

参数：

name - 与系统有关的文件名。

抛出：FileNotFoundException

如果不能找到此文件。

抛出： SecurityException

如果有一个安全管理器，则用给定的参数名调用 checkRead 方法，查看是否允许应用程序读该文件。

参见：

checkRead

 public FileInputStream(File file) throws FileNotFoundException

创建一个输入文件流，从指定的 File 对象读取数据。

参数：

file - 为读打开的文件。

抛出：FileNotFoundException

如果不能找到此文件。

抛出： SecurityException

如果有一个安全管理器，则用参数 File 给定的路径名调用 checkRead 方法，查看是否允许此应用程序读该文件。

参见：

getPath, checkRead

 public FileInputStream(FileDescriptor fdObj)

创建一个输入文件流，从指定的文件描述器读取数据。

参数：

fdObj - 为读打开的文件描述符。

抛出： SecurityException

如果有一个安全管理器，则用参数 File 给定的路径名调用 checkRead 方法，查看是否允许此应用程序读该文件。

参见：

checkRead

方法

 public native int read() throws IOException

从当前输入流中读取一字节数据。 如果没有输入数据则该方法将阻塞。

返回值：

数据的下一个字节；若已读到流尾，则为 -1 。

抛出： IOException

如果发生某个 I/O 错误。

覆盖：

类 InputStream 中的 read

 public int read(byte b[]) throws IOException

将当前输入流中 b.length 个字节数据读到一个字节数组中。 这个方法将阻塞直到有输入数据可用。

参数：

b - 读取数据的缓冲区。

返回值：

读到缓存区的整个字节数；如果读到流尾不再有数据可读则为 -1。

抛出： IOException

如果发生某个 I/O 错误。

覆盖：

类 InputStream 中的 read

 public int read(byte b[],
                   int off,
                 int len) throws IOException

将输入流中 len 个字节数据读入一个字节数组中。 这个方法将阻塞直到有输入数据可用。

参数：

b - 读取数据的缓冲区。

off - 读取数据的起始偏移。

len - 读取的最大字节数。

返回值：

读到缓存区的整个字节数；如果读到流尾不再有数据可读则为 -1。

抛出： IOException

如果发生某个 I/O 错误。

覆盖：

类 InputStream 中的 read

 public native long skip(long n) throws IOException

跳过并删除输入流的 n 字节数据。 skip 方法可能因各种原因终止跳过一些较小的字节数，可能是零。返回实际跳过的字节数。

参数：

n - 跳过的字节数。

返回值：

实际跳过的字节数。

抛出： IOException

如果发生某个 I/O 错误。

覆盖：

类 InputStream 中的 skip

 public native int available() throws IOException

返回从当前文件输入流中可无阻塞读取的字节数。

返回值：

从当前文件输入流中可无阻塞读取的字节数。

抛出： IOException

如果发生某个 I/O 错误。

覆盖：

类 InputStream 中的 available

 public native void close() throws IOException

关闭当前文件输入流，并释放与它相关的任一系统资源。

抛出： IOException

如果发生某个 I/O 错误。

覆盖：

类 InputStream 中的 close

 public final FileDescriptor getFD() throws IOException

返回与当前流相关的不透明的文件描述符。

返回值：

与当前流相关的文件描述符。

抛出： IOException

如果发生某个 I/O 错误。

参见：

FileDescriptor

 protected void finalize() throws IOException

当这个文件输入流不再有引用时，确保调用它的 close 方法。

抛出： IOException

如果发生某个 I/O 错误。

覆盖：

类 Object 中的 finalize

参见：

close