course6.htm

JAVA开发手册,查询JAVASDK的函数!

<p class="title_2">语法</p>
<p>public void close()</p>
<p class="title_2">说明</p>
<p>调用了close方法之后，任何对TextReader对象的操作都将产生异常。</p>
<p>覆盖：Reader.close</p>
<p>TextReader.getStream</p>
<p>检取TextReader对象底层的数据流。</p>
<p class="title_2">语法</p>
<p>public IByteStream getStream ()</p>
<p class="title_2">返回值</p>
<p>返回传递给构造器的数据流或者在构建TextReader对象时自动创建的File对象。</p>
<p>TextReader.peek</p>
<p>检取下一个可用的字符，而并不从数据流中真正读取该字符。</p>
<p class="title_2">语法</p>
<p>public int peek ()</p>
<p class="title_2">返回值</p>
<p>返回下一个要读取的字符，如果没有其他字符，就返回-1。</p>
<p class="title_2">说明</p>
<p>该操作并不改变TextReader当前的指针位置。</p>
<p>覆盖：Reader.peek</p>
<p>TextReader.read</p>
<p>从输入数据流中读取下一个字符。</p>
<p class="title_2">语法</p>
<p>public int read ()</p>
<p>public int read ( char [] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>buffer</p>
<p>保存读入数据的字符矩阵。</p>
<p>index</p>
<p>缓冲区起始位置的索引。</p>
<p>count</p>
<p>要读入的字符数。</p>
<p class="title_2">返回值</p>
<p>从输入数据流中读取下一个字符，如果没有其他字符就返回-1。第二种</p>
<p class="title_2">方法返回所读出的字符总数。这可能比所要求读取的少，因为可能没有那么多的字符，也可能是0，如果已经碰到了输入流的末尾。</p>
<p class="title_2">说明</p>
<p>第二种方法从TextReader中index起始位置处读取count个字符放入buffer字符矩阵。返回实际所读取的字符数。</p>
<p>覆盖：Reader.read</p>
<p>TextReader.readLine</p>
<p>读取一行。</p>
<p class="title_2">语法</p>
<p>public String readLine ()</p>
<p class="title_2">返回值</p>
<p>从输入流中返回一行，或者如果到达输入流的末尾就返回-1。</p>
<p class="title_2">说明</p>
<p>一行定义为以回车键(\r)、换行符(\n)或者回车键后跟换行符结尾的字符序列。结果字符串不包括结尾终止符如回车键和/或换行符。</p>
<p>覆盖：Reader.readLine</p>
<hr><p class="title_1"><a name="TextWriter类">TextWriter类</a></p>
<p>实现可以向IByteStream对象或命名文件写入序列字符流的作者。</p>
<pre>Writer
   |
   +-- TextWriter</pre>
<p>package com.ms.wfc.io</p>
<p>public class TextWriter</p>
<p>extends Writer</p>
<p class="title_2">说明</p>
<p>该类执行输出缓冲操作，并将单一码转换为底层的单字节或双字节字符集。</p>
<p>请参阅：StringWriter, Text , TextReader</p>
<p class="title_2">构造器</p>
<p>TextWriter.TextWriter</p>
<p>创建一个TextWriter对象。</p>
<p class="title_2">语法</p>
<p>public TextWriter ( IByteStream stream )</p>
<p>public TextWriter ( IByteStream stream, int codePage )</p>
<p>public TextWriter ( IByteStream stream, int codePage, int bufferSize )</p>
<p>public TextWriter ( String path )</p>
<p>public TextWriter ( String path, int codePage )</p>
<p>public TextWriter ( String path, int codePage, int bufferSize )</p>
<p class="title_2">参数</p>
<p>stream</p>
<p>要写入数据的IByteStream对象。</p>
<p>codePage</p>
<p>在将单一码字符转换为输出字符时所使用的代码页。该参数必须是CodePage枚举类中的值或者是系统所支持代码页的标识符。</p>
<p>bufferSize</p>
<p>输出缓冲区大小，以字符数表示。如果没有指定该参数的数值，缓冲区的大小就设置为1024个字符长。</p>
<p>path</p>
<p>要创建文件的名字。</p>
<p class="title_2">方法</p>
<p>TextWriter.close</p>
<p>关闭TextWriter对象以及底层的IByteStream对象。</p>
<p class="title_2">语法</p>
<p>public void close()</p>
<p class="title_2">说明</p>
<p>调用该方法之后，任何对TextWriter对象的操作都将产生异常。</p>
<p>覆盖：Writer.close</p>
<p>TextWriter.flush</p>
<p>清除TextWriter对象的输出缓冲区，将缓冲的数据都写入底层的IByteStream对象。</p>
<p class="title_2">语法</p>
<p>public void flush ()</p>
<p class="title_2">说明</p>
<p>如果TextWriter对象的autoFlush属性设置为true，则在每次写操作之后都将自动调用flush方法。</p>
<p>覆盖：Write.flush</p>
<p>请参阅：setAutoFlush</p>
<p>TextWriter.getAutoFlush</p>
<p>检取一个boolean值，指明写操作是否自动将缓冲数据写入底层的IByteStream对象。</p>
<p class="title_2">语法</p>
<p>public boolean getAutoFlush ()</p>
<p class="title_2">返回值</p>
<p>如果写操作自动将缓冲数据写入IByteStream对象，就返回true；否则，就返回false。</p>
<p>请参阅：setAutoFlush</p>
<p>TextWriter.getStream</p>
<p>检取TextWriter对象底层的数据流。</p>
<p class="title_2">语法</p>
<p>public IByteStream getStream ()</p>
<p class="title_2">返回值</p>
<p>返回TextWriter对象底层的数据流。</p>
<p class="title_2">说明</p>
<p>返回传递给构造器的数据流或者在构造TextWriter对象时自动创建的File对象。</p>
<p>TextWriter.setAutoFlush</p>
<p>设置一个boolean值，指明输出字符时使能自动清除缓冲区操作。</p>
<p class="title_2">语法</p>
<p>public void setAutoFlush ( boolean value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>设置为true将使能自动清除缓冲区的操作；设置为false将禁止自动清除缓冲区操作。</p>
<p class="title_2">说明</p>
<p>当使能自动清除缓冲区操作时，在每次写操作之后，输出数据都将自动写入底层的数据流。</p>
<p>请参阅：flush , getAutoFlush</p>
<p>TextWriter.write</p>
<p>将一个字符写入文本数据流。</p>
<p class="title_2">语法</p>
<p>public void write ( char c_value )</p>
<p>public void write ( char[] buffer, int index, int count )</p>
<p>public void write ( String s_value )</p>
<p class="title_2">参数</p>
<p>c_value</p>
<p>要写入文本数据流的字符。</p>
<p>buffer</p>
<p>保存写入数据的字符矩阵。</p>
<p>index缓冲区起始位置索引。</p>
<p>count</p>
<p>要写入的字符数。</p>
<p>s_value</p>
<p>要写入的字符串。</p>
<p>异常</p>
<p>如果缓冲区是null或索引超出范围或数量超出范围，就产生WFCInvalidArgu-mentException异常。</p>
<p class="title_2">说明</p>
<p>使用第二种方法将buffer字符矩阵中index开始位置处的count字符写入该TextWriter对象。如果所指定的字符串是null，就不向文本数据流中写入任何东西。</p>
<p>覆盖：Write.write</p>
<hr><p class="title_1"><a name="WinIOException类">WinIOException类</a></p>
<p>创建一个Windows 输入/输出(I/O)错误异常类。</p>
<pre>IOException
   |
   +-- WinIOException</pre>
<p>package com.ms.wfc.io</p>
<p>public class WinIOException</p>
<p>extends IOException</p>
<p class="title_2">说明</p>
<p>该类用于汇报操作系统所产生的I/O错误。</p>
<p class="title_2">构造器</p>
<p>WinIOException.WinIOException</p>
<p>根据操作系统最近出现的错误创建一个WinIOException对象。</p>
<p class="title_2">语法</p>
<p>public WinIOException()</p>
<p>public WinIOException ( int errorCode )</p>
<p>public WinIOException ( int errorCode , String s )</p>
<p class="title_2">参数</p>
<p>errorCode</p>
<p>错误代码。</p>
<p>s</p>
<p>当出现错误时要显示的文本信息。</p>
<p class="title_2">说明</p>
<p>第一种方法调用com.ms.dll.DllLib.getLastWin32Error方法获取操作系统最近产生的错误代码并根据该错误代码构建一条错误消息。如果你使用J/Direct调用Windows API函数，而且该函数汇报一个错误，你就可以使用该构造器将错误转换为一个WinIOException异常。</p>
<p>第二种方法调用Utils.getSystemErrorMessage方法根据指定的错误代码构建一条错误消息。</p>
<p class="title_2">方法</p>
<p>WinIOException.getErrorCode</p>
<p>检取与该异常关联的错误代码。</p>
<p class="title_2">语法</p>
<p>public int getErrorCode ()</p>
<p class="title_2">返回值</p>
<p>返回该异常的操作系统错误代码。</p>
<hr><p class="title_1"><a name="Writer类">Writer类</a></p>
<p>表示可以写序列字符流的作者。</p>
<p>package com.ms.wfc.io</p>
<p>public abstract class Writer</p>
<p>implements IWriter</p>
<p class="title_2">说明</p>
<p>Writer类是一个抽象类。其子类至少要实现write方法。</p>
<p class="title_2">方法</p>
<p>Writer.close关闭该Writer对象并释放任何与该作者关联的系统资源。</p>
<p class="title_2">语法</p>
<p>pubilc void close ()</p>
<p class="title_2">说明</p>
<p>在调用close方法之后，再对Writer对象做任何操作都将产生异常。缺省方法是空的，但子类可以覆盖该方法以提供正确的功能。</p>
<p>Writer.flush清除Writer对象的缓冲区，将所缓冲的数据都写入底层的设备。</p>
<p class="title_2">语法</p>
<p>public void flush ()</p>
<p class="title_2">说明</p>
<p>缺省方法是空的，但子类可以覆盖该方法以提供正确的功能。</p>
<p>Writer.getNewLine检取该Writer对象所使用的行终止符字符串。</p>
<p class="title_2">语法</p>
<p>public String getNewLine ()</p>
<p class="title_2">返回值</p>
<p>返回行终止符字符串。</p>
<p class="title_2">说明</p>
<p>缺省行终止符字符串是回车键之后跟有一个换行符(\r\n)。</p>
<p>请参阅：setNewLine</p>
<p>Writer.setNewLine</p>
<p>设置该Writer对象的行终止符字符串。</p>
<p class="title_2">语法</p>
<p>public void setNewLine ( String value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>行终止符字符串。</p>
<p class="title_2">说明</p>
<p>每当调用writeLine方法时就将行终止符字符串写入文本数据流中。Reader对象要能读取Writer对象写入的文本，只需要使用下列行终止符之一： \r, \n或\r\n。</p>
<p>请参阅：getNewLine</p>
<p>Writer.writer</p>
<p>将指定的内容写入文本数据流。</p>
<p class="title_2">语法</p>
<p>public void write ( char value )</p>
<p>public void write ( char[] buffer )</p>
<p>public void write ( char[] buffer, int index, int count )</p>
<p>public void write ( boolean b_value )</p>
<p>public void write ( int i_value )</p>
<p>public void write ( long l_value )</p>
<p>public void write ( float f_value )</p>
<p>public void write ( double d_value )</p>
<p>public void write ( String s_value )</p>
<p>public void write ( Object o_value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入文本数据流的字符。</p>
<p>buffer</p>
<p>要写入文本数据流的字符矩阵。</p>
<p>index</p>
<p>缓冲区起始位置索引。</p>
<p>count</p>
<p>要写入的字符数。</p>
<p>b_value</p>
<p>要写入的boolean值。</p>
<p>i_value</p>
<p>要写入的整数。i_value是调用Integer.toString(int)方法产生的。</p>
<p>l_value</p>
<p>要写入的long值。l_value是调用Long.toString(long)方法产生的。</p>
<p>f_value</p>
<p>要写入的float值。f_value是调用Float.toString( float )方法产生的。</p>
<p>d_value</p>
<p>要写入的double值。d_value是调用Double.toString( double)方法产生的。</p>
<p>s_value</p>
<p>要写入的字符串。如果指定字符串为null，就不向文本数据流写入任何内容。</p>
<p>o_value</p>
<p>要写入的对象。</p>
<p class="title_2">说明</p>
<p>缺省方法是空的，但子类可以覆盖该方法以提供正确的功能。第二种方法为字符矩阵中的每个字符调用write(char)方法。如果字符矩阵是null，就不写入任何内容。第三种方法将buffer字符矩阵中index起始位置处的count个字符写入Writer对象中。第四种方法输出字符串“true”或“false”。</p>
<p>如果 o_value 是 null，则字符串“null”就写入文本数据流中。否则，调用该对象的 toString 方法生成字符串表示，并将得到的结果字符串写入输出数据流。</p>
<p>Writer.writerLine</p>
<p>将指定的内容写入文本数据流，后跟一个行终止符。</p>
<p class="title_2">语法</p>
<p>public void writeLine()</p>
<p>public void writeLine ( char value )</p>
<p>public void writeLine ( char[] buffer )</p>
<p>public void writeLine ( char[] buffer, int index, int count)</p>
<p>public void writeLine ( boolean b_value )</p>
<p>public void writeLine ( int i_value )</p>
<p>public void writeLine ( long l_value )</p>
<p>public void writeLine ( float f_value )</p>
<p>public void writeLine ( double d_value )</p>
<p>public void writeLine ( String s_value )</p>
<p>public void writeLine ( Object o_value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入文本数据流的字符。</p>
<p>buffer</p>
<p>要写入文本数据流的字符矩阵。</p>
<p>index</p>
<p>缓冲区起始位置索引。</p>
<p>count</p>
<p>要写入的字符数。</p>
<p>b_value</p>
<p>要写入的boolean值。</p>
<p>i_value</p>
<p>要写入的整数。</p>
<p>l_value</p>
<p>要写入的long值。</p>
<p>f_value</p>
<p>要写入的float值。</p>
<p>d_value</p>
<p>要写入的double值。</p>
<p>s_value</p>
<p>要写入的字符串。</p>
<p>o_value</p>
<p>要写入的对象。</p>
<p>异常</p>
<p>如果缓冲区是null或索引超出范围或者数量超出范围，就产生WFCInvalidArgu-mentException异常。</p>
<p class="title_2">说明</p>
<p>缺省行终止符是回车键后跟一个换行符(\r\n)，但可以使用setNewLine</p>
<p class="title_2">方法改变该缺省值。</p>

</body>
</html>