javatm platform
standard ed. 6

java.io
类 reader

java.lang.object 继承者 java.io.reader
所有〖suǒ yǒu〗已实现的接口:
closeable, readable
直接已知子类:
bufferedreader, chararrayreader, filterreader, inputstreamreader, pipedreader, stringreader

public abstract class reader
extends object
implements readable, closeable

用于读取字符流的抽象类。子类必须实现的方法只有 read(char[], int, int) 和 close()。但是〖dàn shì〗,多数子类将重写此处定义的一些方法,以提供更高的效率和/或其他〖qí tā〗功能。

从以下版本开始〖appeared〗:
jdk1.1
另请参见:
bufferedreader,linenumberreader,chararrayreader,inputstreamreader,filereader,filterreader,pushbackreader,pipedreader,stringreader,writer

字段摘要
protected  objectlock
          用于同步针对此流的操作的对象。js随机数
 
构造方法摘要
protected reader()
          创建一个新的字符流 reader,其重要〖important〗部分将同步其自身的 reader。
protected reader(object lock)
          创建一个新的字符流 reader,其重要〖important〗部分将同步给定的对象。
 
方法摘要
abstract  voidclose()
          关闭该流并释放与之关联的所有资源。
 voidmark(int readaheadlimit)
          标记流中的当前位置〖wèi zhi〗。
 booleanmarksupported()
          判断此流是否支持〖zhī chí〗 mark() 操作。
 intread()
          读取单个字符。
 intread(char[] cbuf)
          将字符读入数组。
abstract  intread(char[] cbuf,int off,int len)
          将字符读入数组的某一部分。
 intread(charbuffer target)
          试图将字符读入指定的字符缓冲区。
 booleanready()
          判断是否准备〖zhǔn bèi〗读取此流。
 voidreset()
          重置该流。
 longskip(long n)
          跳过字符。
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait
 

日前全代会上川普太太梅兰妮亚(Melania Trump)才被抓包剽窃第一夫人蜜雪儿8年前的演说词,看来川普竞选团队对
英国专家近日发表研究,利用新研发技术,发现透过DNA来比对性别及学习态度〖attitudes〗等因素,更能?嗜吩げ庑『⒃谘?吧系某删停而使老师〖teacher〗和家长能帮助孩子解决〖jiě jué〗及面对学习困难
据多家外电报导,土耳其当局平定政变后,进行秋后算帐,2天内逮捕了6000名以上叛乱人士,包括〖included〗军人,警察〖jǐng chá〗及政界人士,甚至要求多个教育〖education〗机构关闭、教育〖education〗部也吊销近2万1千名私营教育老师〖teacher〗职业资格,更有1577名学院院长被勒令退休
郝龙斌认为,省小钱还不如设法增加收入,生活品质要提高靠的是赚大钱,而不是省小钱;这是连一般民众都知道〖knew〗的观念,城市〖chéng shì〗治理也是如此;他表示,8人的急诊室当然和8万人团队不一样;台北市的治理也不需要头痛医头、脚痛医脚的急救
据了解,埃文斯现在在一间机构担任美术设计师,至于他到底付了多少钱,则没有透露
女童母亲解释,女儿今年刚从幼稚园毕业,前阵子办理小学入学手续的时候〖shí hou〗,听到其他〖qí tā〗家长们都在讨论〖discussion〗,
根据《新浪网》报导,中国〖zhōng guó〗社会科学〖kē xué〗院亚太与全球战略研究院副研究员杜继锋认为,越南〖Vietnam〗媒体翻炒多年前的旧事,只是想引起国际社会或中国〖zhōng guó〗当局的注意〖危险信号〗,以
后来在民警再三的开导下,夫妻俩才停止了争吵,并表示会充分考虑女儿的意见〖remark〗,再决定她要学的才艺
字段详细小約ense〗畔

lock

protected object lock
用于同步针对此流的操作的对象。为了提高效率,字符流对象可以〖 kě yǐ〗使用其自身以外的对象来保护重要部分。因此〖 yīn cǐ〗,子类应使用此字段中的对象,而不是 this 或者同步的方法。

构造方法详细信息

reader

protected reader()
创建一个新的字符流 reader,其重要部分将同步其自身的 reader。


reader

protected reader(object lock)
创建一个新的字符流 reader,其重要部分将同步给定的对象。

参数:
lock - 要同步的对象。
方法详细信息

read

public int read(charbuffer target)   throws ioexception
试图将字符读入指定的字符缓冲区。缓冲区可照原样用作字符的存储库:所做的唯一〖sole〗改变是 put 操作的结果。不对缓冲区执行翻转或重绕操作。

指定者:
接口 readable 中的 read
参数:
target - 要将字符读入的缓冲区
返回:
添加到缓冲区的字符数量,如果此字符源位于缓冲区末端,则返回 -1
抛出:
ioexception - 如果发生〖occasionally occurred〗 i/o 错误
nullpointerexception - 如果目标为空
readonlybufferexception - 如果目标是一个只读缓冲区
从以下版本开始〖appeared〗:
1.5

read

public int read()   throws ioexception
读取单个字符。在字符可用、发生〖occasionally occurred〗 i/o 错误或者已到达流的末尾前,此方法一直阻塞。

用于支持〖zhī chí〗高效的单字符输入的子类应重写此方法。

返回:
作为整数读取的字符,范围在 0 到 65535 之间 (0x00-0xffff),如果已到达流的末尾,则返回 -1
抛出:
ioexception - 如果发生 i/o 错误

read

public int read(char[] cbuf)   throws ioexception
将字符读入数组。在某个输入可用、发生 i/o 错误或者已到达流的末尾前,此方法一直阻塞。

参数:
cbuf - 目标缓冲区
返回:
读取的字符数,如果已到达流的末尾,则返回 -1
抛出:
ioexception - 如果发生 i/o 错误

read

public abstract int read(char[] cbuf,     int off,     int len)   throws ioexception
将字符读入数组的某一部分。在某个输入可用、发生 i/o 错误或者到达流的末尾前,此方法一直阻塞。

参数:
cbuf - 目标缓冲区
off - 开始存储字符处的偏移量
len - 要读取的最多字符数
返回:
读取的字符数,如果已到达流的末尾,则返回 -1
抛出:
ioexception - 如果发生 i/o 错误

skip

public long skip(long n)   throws ioexception
跳过字符。在某个字符可用、发生 i/o 错误或者已到达流的末尾前,此方法一直阻塞。

参数:
n - 要跳过的字符数
返回:
实际跳过的字符数
抛出:
illegalargumentexception - 如果 n 为负。
ioexception - 如果发生 i/o 错误

ready

public boolean ready()   throws ioexception
判断是否准备〖zhǔn bèi〗读取此流。

返回:
如果保证下一个 read() 不阻塞输入,则返回 true,否则返回 false。注意〖危险信号〗,返回 false 并不保证阻塞下一次读取。
抛出:js随机数
ioexception - 如果发生 i/o 错误

marksupported

public boolean marksupported()
判断此流是否支持 mark() 操作。默认实现始终返回 false。子类应重写此方法。

返回:
当且仅当此流支持此 mark 操作时,返回 true。

mark

public void mark(int readaheadlimit)   throws ioexception
标记流中的当前位置〖wèi zhi〗。对 reset() 的后续调用将尝试将该流重新定位到此点。并不是所有的字符输入流都支持 mark() 操作。

参数:
readaheadlimit - 在仍保留该标记的情况下,对可读取字符数量的限制。在读取这样〖then〗多的字符后,尝试重置流可能〖kě néng〗会失败。
抛出:
ioexception网站地图 手机端 - 如果该流不支持 mark(),或者发生一些其他 i/o 错误

reset

public void reset()  throws ioexception
重置该流。如果已标记该流,则尝试在该标记处重新定位该流。如果已标记该流,则以适用于特定流的某种方式尝试重置该流,例如,通过将该流重新定位到其起始点。并不是所有的字符输入流都支持 reset() 操作,有些支持 reset() 而不支持 mark()。

抛出:
ioexception - 如果尚未标记流,或者该标记已失效,或者该流不支持 reset(),或者发生一些其他 i/o 错误

close

public abstract void close()    throws ioexception
关闭该流并释放与之关联的所有资源。在关闭该流后,再调用 read()、ready()、mark()、reset() 或 skip() 将抛出 ioexception。关闭以前关闭的流无效。

指定者:
接口 closeable 中的 close
抛出:
ioexception - 如果发生 i/o 错误

javatm platform
standard ed. 6

提交错误或意见〖remark〗
有关更多的 api 参考资料和开发〖developing〗人员文档,请参阅 java se 开发〖developing〗人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作〖gōng zuò〗代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策