📄 course6.htm
字号:
<html>
<head>
<title>course6</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<base target="_self">
<style>.title_1 { text-align: left; line-height: 100%; color: #000080; font-weight: bold;
margin-top: 14; margin-bottom: 14 }
.title_2 { font-weight: bold }
.Cross_ref{ font-weight: bold; margin-left: 18 }
</style>
</head>
<body bgcolor="#FFFFFF">
<p class="title_1"><a name="IDataStream界面">IDataStream界面</a></p>
<p>表示了一个允许以各种格式进行读写操作的数据流。</p>
<pre>IByteStream
|
+-- IDataStream</pre>
<p>package com.ms.wfc.io</p>
<p>public interface IDataStream</p>
<p>extends IByteStream</p>
<p class="title_2">说明</p>
<p>该界面是IByteStream界面的扩展。</p>
<p>请参阅:BufferedStream, DataStream, File , MemeoryStream</p>
<p class="title_2">方法</p>
<p>IDataStream.getComStream</p>
<p>检取该数据流的与COM兼容的IStream对象。</p>
<p class="title_2">语法</p>
<p>public IStream getComStream ()</p>
<p class="title_2">返回值</p>
<p>返回代表该数据流的IStream。</p>
<p class="title_2">说明</p>
<p>所返回的IStream对象与该数据流的当前的指针位置和长度都相同。二者在后续的操作中都保持同步。</p>
<p>请参阅:com.ms.com.IStream</p>
<p>IDataStream.readBoolean</p>
<p>从数据流中读取单个字节。</p>
<p class="title_2">语法</p>
<p>public boolean readBoolean ()</p>
<p class="title_2">返回值</p>
<p>如果字节非0,就返回true,否则,如果字节是0,就返回false。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。如果数据流到达末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动一个字节。</p>
<p>请参阅:writeBoolean</p>
<p>IDataStream.readByte</p>
<p>从数据流中读取一个字节。</p>
<p class="title_2">语法</p>
<p>public byte readByte()</p>
<p class="title_2">返回值</p>
<p>返回所读取的字节。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。如果数据流到达末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动一个字节。</p>
<p>请参阅:writebyte</p>
<p>IDataStream.readBytes</p>
<p>从数据流中读取指定数量的字节数放入一个字节矩阵中。</p>
<p class="title_2">语法</p>
<p>public byte[] readBytes( int count )</p>
<p>public void readBytes ( byte[] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>count</p>
<p>要读取的字节数。buffer保存读取数据的矩阵。</p>
<p>index</p>
<p>矩阵中开始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回包含所读取字节的字节矩阵。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。如果在读取数据时到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动count字节。</p>
<p>请参阅:IByteStream,read, readToEnd, writeBytes</p>
<p>IDataStream.readChar</p>
<p>从数据流中读取一个字符。</p>
<p class="title_2">语法</p>
<p>public char readChar()</p>
<p class="title_2">返回值</p>
<p>返回所读取的字符。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取两个字节之前就到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动两个字节。</p>
<p>请参阅:writeChar</p>
<p>IDataStream.readChars</p>
<p>从数据流中读取指定数量的字符数放入一个字符矩阵中。</p>
<p class="title_2">语法</p>
<p>public char[] readChars( int count )</p>
<p>public void readChars ( char [] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>count</p>
<p>要读取的字符数。</p>
<p>buffer</p>
<p>保存读取数据的矩阵。</p>
<p>index</p>
<p>矩阵中开始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回包含所读取字符的字符矩阵。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动count*2字节。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。如果在读取数据时到达数据流的末尾,就产生EOFException异常。</p>
<p>请参阅:writeChars</p>
<p>IDataStream.readDouble</p>
<p>从数据流中读取一个double值。</p>
<p class="title_2">语法</p>
<p>public double readDouble()</p>
<p class="title_2">返回值</p>
<p>返回所读取的double值。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取8个字节之前就到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动8个字节。</p>
<p>请参阅:writeDouble</p>
<p>IDataStream.readDoubles</p>
<p>从数据流中读取指定数量的double值放入一个double矩阵中。</p>
<p class="title_2">语法</p>
<p>public double[] readDoubles( int count )</p>
<p>public void readDoubles ( double[] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>count</p>
<p>要读取double值的数量。</p>
<p>buffer</p>
<p>保存读取数据的矩阵。</p>
<p>index</p>
<p>矩阵中开始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回包含所读取数据的double矩阵。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。如果在读取数据时到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动count*8字节。</p>
<p>请参阅:writeDoubles</p>
<p>IDataStream.readFloat</p>
<p>从数据流中读取一个float值。</p>
<p class="title_2">语法</p>
<p>public float readFloat()</p>
<p class="title_2">返回值</p>
<p>返回所读取的float值。异常如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取4个字节之前就到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动4个字节。</p>
<p>请参阅:writeFloat</p>
<p>IDataStream.readFloats</p>
<p>从数据流中读取指定数量的float值放入一个float矩阵中。</p>
<p class="title_2">语法</p>
<p>public float[] readFloats( int count )</p>
<p>public void readFloats ( float[] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>count</p>
<p>要读取float值的数量。</p>
<p>buffer</p>
<p>保存读取数据的矩阵。</p>
<p>index</p>
<p>矩阵中开始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回包含所读取数据的float矩阵。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。如果在读取数据时到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动count*4字节。</p>
<p>请参阅:writeFloats</p>
<p>IDataStream.readInt</p>
<p>从数据流中读取一个整数。</p>
<p class="title_2">语法</p>
<p>public int readInt()</p>
<p class="title_2">返回值</p>
<p>返回所读取的整数值。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取4个字节之前就到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动4个字节。</p>
<p>请参阅:writeInt</p>
<p>IDataStream.readInts</p>
<p>从数据流中读取指定数量的整数值放入一个整数矩阵中。</p>
<p class="title_2">语法</p>
<p>public int[] readInts( int count )</p>
<p>public void readInts ( int[] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>count</p>
<p>要读取整数值的数量。</p>
<p>buffer</p>
<p>保存读取数据的矩阵。</p>
<p>index</p>
<p>矩阵中开始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回包含所读取数据的整数矩阵。</p>
<p class="title_2">异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。如果在读取数据时到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动count*4字节。</p>
<p>请参阅:writeInts</p>
<p>IDataStream.readLong</p>
<p>从数据流中读取一个long值。</p>
<p class="title_2">语法</p>
<p>public long readLong()</p>
<p class="title_2">返回值</p>
<p>返回所读取的long值。</p>
<p class="title_2">异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取8个字节之前就到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动8个字节。</p>
<p>请参阅:writeLong</p>
<p>IDataStream.readLongs</p>
<p>从数据流中读取指定数量的long值放入一个long矩阵中。</p>
<p class="title_2">语法</p>
<p>public long[] readLongs( int count )</p>
<p>public void readLongs ( long[] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>count</p>
<p>要读取长整数的数量。buffer保存读取数据的矩阵。</p>
<p>index</p>
<p>矩阵中开始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回包含所读取数据的长整数矩阵。</p>
<p class="title_2">异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取数据时到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动count*8字节。</p>
<p>请参阅:writelongs</p>
<p>IDataStream.readShort</p>
<p>从数据流中读取一个short值。</p>
<p class="title_2">语法</p>
<p>public short readShort()</p>
<p class="title_2">返回值</p>
<p>返回所读取的short值。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取两个字节之前就到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动两个字节。</p>
<p>请参阅:writeShort</p>
<p>IDataStream.readShorts</p>
<p>从数据流中读取指定数量的短整数值放入一个短整数矩阵中。</p>
<p class="title_2">语法</p>
<p>public short[] readShorts( int count )</p>
<p>public void readShorts ( short[] buffer, int index, int count )</p>
<p class="title_2">参数</p>
<p>count</p>
<p>要读取短整数的数量。</p>
<p>buffer</p>
<p>保存读取数据的矩阵。</p>
<p>index</p>
<p>矩阵中开始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回包含所读取数据的短整数矩阵。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取数据时到达数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>数据流当前的指针位置向前移动count*2字节。</p>
<p>请参阅:writeShorts</p>
<p>IDataStream.readString</p>
<p>从数据流中读取预定长单一码字符串。</p>
<p class="title_2">语法</p>
<p>public String readString()</p>
<p class="title_2">返回值</p>
<p>返回所读取的字符串。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取字符串时到达了数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>该方法先以32位无符号整数的形式读取字符串长度,然后将这么多的16位单一码字符读入字符串中。</p>
<p>请参阅:writeString</p>
<p>IDataStream.readStringChars</p>
<p>从数据流中读取单一码字符串。</p>
<p class="title_2">语法</p>
<p>public String readStringChars( int length )</p>
<p class="title_2">参数</p>
<p>length</p>
<p>要读取的字符数。</p>
<p class="title_2">返回值</p>
<p>返回所读取的字符串。</p>
<p>异常如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取字符串时到达了数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>该方法先从数据流读取length长的16位单一码字符,然后返回包含这些字符的字符串。</p>
<p>请参阅:writeStringChars</p>
<p>IDataStream.readStringCharsAnsi</p>
<p>从数据流中读取ANSI字符串。</p>
<p class="title_2">语法</p>
<p>public String readStringCharsAnsi( int length )</p>
<p class="title_2">参数</p>
<p>length</p>
<p>要读取的字符数。</p>
<p class="title_2">返回值</p>
<p>返回所读取的字符串。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作,就产生IOException异常。</p>
<p>如果在读取字符串时到达了数据流的末尾,就产生EOFException异常。</p>
<p class="title_2">说明</p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -