文件输入流是一个从 File
或 FileDescriptor
读取数据的输入流。
类 java.io.FileInputStream
类 java.io.FileInputStream
java.lang.Object
|
+----java.io.InputStream
|
+----java.io.FileInputStream
- public class FileInputStream
- extends InputStream
- 来自:
- 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
字节数据。
构造子
FileInputStream
public FileInputStream(String name) throws FileNotFoundException
- 创建一个输入文件流,从指定名称的文件读取数据。
- 参数:
- name - 与系统有关的文件名。
- 抛出:FileNotFoundException
- 如果不能找到此文件。
- 抛出:
SecurityException
- 如果有一个安全管理器,则用给定的参数名调用
checkRead
方法,查看是否允许应用程序读该文件。
- 参见:
- checkRead
FileInputStream
public FileInputStream(File file) throws FileNotFoundException
- 创建一个输入文件流,从指定的
File
对象读取数据。
- 参数:
- file - 为读打开的文件。
- 抛出:FileNotFoundException
- 如果不能找到此文件。
- 抛出:
SecurityException
- 如果有一个安全管理器,则用参数
File
给定的路径名调用
checkRead
方法,查看是否允许此应用程序读该文件。
- 参见:
- getPath, checkRead
FileInputStream
public FileInputStream(FileDescriptor fdObj)
- 创建一个输入文件流,从指定的文件描述器读取数据。
- 参数:
- fdObj - 为读打开的文件描述符。
- 抛出:
SecurityException
- 如果有一个安全管理器,则用参数
File
给定的路径名调用
checkRead
方法,查看是否允许此应用程序读该文件。
- 参见:
- checkRead
方法
read
public native int read() throws IOException
- 从当前输入流中读取一字节数据。 如果没有输入数据则该方法将阻塞。
- 返回值:
- 数据的下一个字节;若已读到流尾,则为
-1
。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 覆盖:
- 类
InputStream 中的 read
read
public int read(byte b[]) throws IOException
- 将当前输入流中
b.length
个字节数据读到一个字节数组中。 这个方法将阻塞直到有输入数据可用。
- 参数:
- b - 读取数据的缓冲区。
- 返回值:
- 读到缓存区的整个字节数;如果读到流尾不再有数据可读则为
-1
。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 覆盖:
- 类 InputStream 中的
read
read
public int read(byte b[],
int off,
int len) throws IOException
- 将输入流中
len
个字节数据读入一个字节数组中。 这个方法将阻塞直到有输入数据可用。
- 参数:
- b - 读取数据的缓冲区。
- off - 读取数据的起始偏移。
- len - 读取的最大字节数。
- 返回值:
- 读到缓存区的整个字节数;如果读到流尾不再有数据可读则为
-1
。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 覆盖:
- 类 InputStream
中的
read
skip
public native long skip(long n) throws IOException
- 跳过并删除输入流的
n
字节数据。
skip
方法可能因各种原因终止跳过一些较小的字节数,可能是零。返回实际跳过的字节数。
- 参数:
- n - 跳过的字节数。
- 返回值:
- 实际跳过的字节数。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 覆盖:
- 类 InputStream
中的 skip
available
public native int available() throws IOException
- 返回从当前文件输入流中可无阻塞读取的字节数。
- 返回值:
- 从当前文件输入流中可无阻塞读取的字节数。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 覆盖:
- 类
InputStream 中的
available
close
public native void close() throws IOException
- 关闭当前文件输入流,并释放与它相关的任一系统资源。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 覆盖:
- 类
InputStream 中的 close
getFD
public final FileDescriptor getFD() throws IOException
- 返回与当前流相关的不透明的文件描述符。
- 返回值:
- 与当前流相关的文件描述符。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 参见:
- FileDescriptor
finalize
protected void finalize() throws IOException
- 当这个文件输入流不再有引用时,确保调用它的
close
方法。
- 抛出:
IOException
- 如果发生某个 I/O 错误。
- 覆盖:
- 类 Object 中的
finalize
- 参见:
- close