compact1, compact2, compact3

java.io

Class InputStreamReader

java.lang.Object

java.io.Reader

java.io.InputStreamReader

All Implemented Interfaces:

Closeable， AutoCloseable， Readable

已知直接子类：

FileReader

public class InputStreamReader
extends Reader

一个inputstreamreader是桥从字节流字符流：将字节数组解码成文字使用指定的 charset。字符集，它使用可指定名称或可给予明确，或平台的默认字符集可以接受。

每次调用一个inputstreamreader的read()方法可能会导致一个或多个字节是从底层字节输入流中读取。为了使字节的有效转换为字符，更多的字节可以从底层流读取，而不是满足当前读操作的必要。

为了获得最好的效率，考虑包装inputstreamreader在体。例如:

BufferedReader=是（新inputstreamreader（系统的））；

从以下版本开始：

JDK1.1

另请参见：

BufferedReader， InputStream， Charset

Field Summary

Fields inherited from class java.io.Reader

lock

构造方法摘要

构造方法

Constructor and Description
InputStreamReader(InputStream in) 创建一个inputstreamreader使用默认字符集。
InputStreamReader(InputStream in, Charset cs) 创建一个inputstreamreader使用给定的字符集。
InputStreamReader(InputStream in, CharsetDecoder dec) 创建一个inputstreamreader使用给定的字符集解码。
InputStreamReader(InputStream in, String charsetName) 创建一个inputstreamreader使用指定的字符集。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭流并释放与它相关联的任何系统资源。
String	getEncoding() 返回此流使用的字符编码的名称。
int	read() 读取单个字符。
int	read(char[] cbuf, int offset, int length) 将字符读入一个数组的一部分。
boolean	ready() 告诉是否该流已准备好阅读。

Methods inherited from class java.io.Reader

mark, markSupported, read, read, reset, skip

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InputStreamReader

public InputStreamReader(InputStream in)

创建一个inputstreamreader使用默认字符集。

参数

in - An InputStream

InputStreamReader

public InputStreamReader(InputStream in,
                         String charsetName)
                  throws UnsupportedEncodingException

创建一个inputstreamreader使用指定的字符集。

参数

in - An InputStream

charsetName -支持的 charset名称

异常

UnsupportedEncodingException -如果指定的字符集不支持

InputStreamReader

public InputStreamReader(InputStream in,
                         Charset cs)

创建一个inputstreamreader使用给定的字符集。

参数

in - An InputStream

cs -字符集

从以下版本开始：

一点四

InputStreamReader

public InputStreamReader(InputStream in,
                         CharsetDecoder dec)

创建一个inputstreamreader使用给定的字符集解码。

参数

in - An InputStream

dec -字符集解码

从以下版本开始：

一点四

方法详细信息

getEncoding

public String getEncoding()

返回此流使用的字符编码的名称。

如果编码具有一个历史名称，则返回名称；否则将返回编码的规范名称。

如果这种情况与InputStreamReader(InputStream, String)然后构造函数返回的名称创建独特的编码，可能与名字传递给构造函数。这个方法将返回null流已经关闭。

结果

这种编码的历史名称，或 null如果流已关闭

另请参见：

Charset

read

public int read()
         throws IOException

读取单个字符。

重写：

read 方法重写，继承类 Reader

结果

字符读取，或-如果流的结束已达到- 1

异常

IOException如果I/O错误发生

read

public int read(char[] cbuf,
                int offset,
                int length)
         throws IOException

将字符读入一个数组的一部分。

Specified by:

read 方法重写，继承类 Reader

参数

cbuf -目的缓冲区

offset偏移，开始存储字符

length -最大字符数读

结果

读取的字符数，或-如果流的结束已达到- 1

异常

IOException如果I/O错误发生

ready

public boolean ready()
              throws IOException

告诉是否该流已准备好阅读。如果输入缓冲区不空inputstreamreader准备，或如果字节可以从底层的字节流中读取。

重写：

ready 方法重写，继承类 Reader

结果

如果下一read()保证不阻塞输入真，否则为假。请注意，返回错误不保证下一次读将块。

异常

IOException如果I/O错误发生

close

public void close()
           throws IOException

从阶级复制的描述： Reader

关闭流并释放与它相关联的任何系统资源。一旦流已经关闭，进一步read()，ready()，mark()，reset()，或skip()调用会抛出IOException。关闭先前关闭的流没有影响。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

Specified by:

close 方法重写，继承类 Reader

异常

IOException如果I/O错误发生