course5.htm

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

<p>public boolean canSeek ()</p>
<p class="title_2">返回值</p>
<p>如果数据流支持寻址操作，就返回true；否则，就返回false。</p>
<p>异常</p>
<p>如果出现I/O错误，就产生IOException异常消息。</p>
<p class="title_2">说明</p>
<p>该方法实现了IByteSteam.canSeek方法。这个缺省方法总是返回true，你可以在子类中覆盖该方法从而提供正确的功能。</p>
<p>请参阅：write</p>
<p>DataStream.canWrite</p>
<p>确定数据流是否支持写入操作。</p>
<p class="title_2">语法</p>
<p>public boolean canWrite()</p>
<p class="title_2">返回值</p>
<p>如果数据流支持写入操作就返回true。否则就返回false。</p>
<p>异常</p>
<p>如果出现I/O错误或数据流不支持写入操作就产生IOException异常消息。</p>
<p class="title_2">说明</p>
<p>该方法实现了IByteStream.canWrite方法。该缺省方法总是返回true，但子类可以覆盖该方法以提供正确的功能。</p>
<p>请参阅：write</p>
<p>DataStream.close</p>
<p>关闭数据流。</p>
<p class="title_2">语法</p>
<p>public void close()</p>
<p class="title_2">说明</p>
<p>该方法实现了IByteStream.close方法。这个缺省的方法是空的，但子类可以覆盖该方法以提供正确的功能。</p>
<p>DataStream.flush</p>
<p>将该数据流缓冲数据处理完毕。</p>
<p class="title_2">语法</p>
<p>public void flush()</p>
<p class="title_2">说明</p>
<p>该方法实现了IByteStream.flush方法。缺省方法是空的，但子类可以覆盖它以提供正确的功能。</p>
<p>DataStream.fromComStream</p>
<p>从IStream对象中检取一个IDataStream对象。</p>
<p class="title_2">语法</p>
<p>pubilc static IDataStream fromComStream ( IStream comStream )</p>
<p class="title_2">参数</p>
<p>comStream</p>
<p>创建IDataStream对象的com. ms.com.IStream。返回值为指定的IStream对象返回一个IDataStream对象，或者如果comStream参数是null就返回null。</p>
<p class="title_2">说明</p>
<p>如果有一个与COM兼容的IStream对象而需要一个IDataStream对象，就可以使用该方法创建一个适配器。</p>
<p>请参阅：getComStream, toComStream</p>
<p>DataStream.getComStream</p>
<p>从数据流中检取IStream。</p>
<p class="title_2">语法</p>
<p>public IStream getComStream ()</p>
<p class="title_2">返回值</p>
<p>返回该数据流与COM兼容的com.ms.com.IStream实现。该对象被缓存以便后续对getComStream的调用并返回结果。</p>
<p>请参阅：fromComStream, toComStream</p>
<p>DataStream.getLength</p>
<p>检取数据流的长度。</p>
<p class="title_2">语法</p>
<p>public long getLength()</p>
<p class="title_2">返回值</p>
<p>返回数据流的长度。</p>
<p class="title_2">说明</p>
<p>该方法实现了IByteStream.getLength方法。这个缺省实现将产生IOException，你可以在子类中覆盖该方法以提供正确的功能。</p>
<p>DataStream.getPosition</p>
<p>检取数据流的位置。</p>
<p class="title_2">语法</p>
<p>public long getPosition()</p>
<p class="title_2">说明</p>
<p>该方法实现了IByteStream.getPosition方法。这个缺省实现将产生IOException，你可以在子类中覆盖该方法以提供正确的功能。</p>
<p class="title_2">返回值</p>
<p>返回数据流当前的位置。</p>
<p>DataStream.read</p>
<p>从数据流中读取下一个字节。</p>
<p class="title_2">语法</p>
<p>public int read()</p>
<p>public int read ( byte[] 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 class="title_2">返回值</p>
<p>返回所读取的字节数。</p>
<p class="title_2">说明</p>
<p>该方法实现了IByteStream.read方法。这个缺省实现将产生IOException，你可以在子类中覆盖该方法以提供正确的功能。第一个不带参数的方法将从数据流中读取下一个字节。第二个带参数的方法先验证参数是否有效，然后再调用readCore方法读取数据。DataStream.readBoolean从数据流中读取boolean值。</p>
<p class="title_2">语法</p>
<p>public boolean readBoolean ()</p>
<p class="title_2">返回值</p>
<p>如果字节非零就返回true；否则就返回false。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readBoolean方法。该方法调用read方法读取字节。DataStream.readByte从数据流中读取一个字节。</p>
<p class="title_2">语法</p>
<p>public byte readByte()</p>
<p class="title_2">返回值</p>
<p>从数据流中返回一个字节。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readByte方法。该方法调用read方法读取字节。</p>
<p>DataStream.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>buffer</p>
<p>保存读入数据的矩阵。</p>
<p>index</p>
<p>矩阵中起始位置的索引。</p>
<p>count</p>
<p>要读取的字节数。</p>
<p class="title_2">返回值</p>
<p>返回一个字节矩阵，包含了所读取的字节。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readBytes方法。该方法调用read方法读取字节。</p>
<p>DataStream.readChar</p>
<p>从数据流中读取一个字符。</p>
<p class="title_2">语法</p>
<p>public char readChar()</p>
<p class="title_2">返回值</p>
<p>从数据流中读取一个字符。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readChar方法。该方法调用read方法读取两个字节并将这两个字节组合为一个字符。</p>
<p>DataStream.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>buffer</p>
<p>保存读入数据的矩阵。</p>
<p>index</p>
<p>矩阵中起始位置的索引。</p>
<p>count</p>
<p>要读入的字节数。返回值返回一个字符矩阵，包含了所读取的数据。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readChars方法。该方法先验证参数是否有效，然后调用readCore方法来读取数据。</p>
<p>DataStream.readCore</p>
<p>实现核心矩阵读取方法。</p>
<p class="title_2">语法</p>
<p>protected int readCore ( Object buffer, int offset, int count )</p>
<p class="title_2">参数</p>
<p>buffer</p>
<p>要读入原子类型矩阵。</p>
<p>offsetbuffer</p>
<p>偏移量字节数。</p>
<p>count</p>
<p>要读的buffer的字节数。</p>
<p class="title_2">返回值</p>
<p>从数据流中返回一个数据矩阵。</p>
<p class="title_2">异常</p>
<p>如果出现错误或者数据流不支持读取操作，就产生IOException异常消息。</p>
<p class="title_2">说明</p>
<p>该方法被类中其他的矩阵读取方法所调用。该方法将count个字节的数据读到buffer中的offset位置处。buffer参数必须保证为byte[], char[],short[], int[], long[],float[]或double[]类型。该方法的起始实现将产生IOException异常消息，但你可以在子类中覆盖该方法以提供正确的功能。</p>
<p>DataStream.readDouble</p>
<p>从数据流中读取double值。</p>
<p class="title_2">语法</p>
<p>public double readDouble ()</p>
<p class="title_2">返回值</p>
<p>返回所读取的double值。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readDouble方法。该方法调用readLong方法读取long值，然后再转换为double值。</p>
<p>DataStream.readDoubles</p>
<p>从数据流中读取指定数量的双字节数值放入到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>要读取的双字节数量。</p>
<p>buffer</p>
<p>保存读入数据的矩阵。</p>
<p>index</p>
<p>矩阵中起始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回一个双字节矩阵，包含了所读取的字节。说明该方法实现了IDataStream.readDoubles方法。该方法先验证参数是否有效，然后调用readCore方法来读取数据。</p>
<p>DataStream.readFloat</p>
<p>从数据流中读取float值。</p>
<p class="title_2">语法</p>
<p>public float readFloat ()</p>
<p class="title_2">返回值</p>
<p>返回所读取的float值。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readFloat方法。该方法调用readInt方法读取整数值，然后再转换为float值。</p>
<p>请参阅：write</p>
<p>FloatDataStream.reaFloats</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>buffer</p>
<p>保存读入数据的矩阵。</p>
<p>index</p>
<p>矩阵中起始位置的索引。</p>
<p>count</p>
<p>要读取浮点数的数量。</p>
<p class="title_2">返回值</p>
<p>返回float矩阵，包含了所读取的字节。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readFloats方法。该方法先验证参数是否有效，然后调用readCore方法来读取数据。</p>
<p>DataStream.readInt</p>
<p>从数据流中读取整数值。</p>
<p class="title_2">语法</p>
<p>public int readInt ()</p>
<p class="title_2">返回值</p>
<p>返回所读取的整数值。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readInt方法。该方法调用read方法读取4个字节，然后再转换为整数值。DataStream.readInts从数据流中读取指定数量的整数值放入到整数矩阵中。</p>
<p class="title_2">语法</p>
<p>public int[] readInts ( int count )public void readInts ( int[] 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>该方法实现了IDataStream.readInts方法。该方法先验证参数是否有效，然后调用readCore方法来读取数据。DataStream.readLong从数据流中读取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>该方法实现了IDataStream.readLong方法。该方法调用readInt方法两次读取两个整数，然后再转换为长整数值。</p>
<p>DataStream.readLongs</p>
<p>从数据流中读取指定数量的长整数放入到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>要读取的长整数的数量。</p>
<p>buffer</p>
<p>保存读入数据的矩阵。</p>
<p>index</p>
<p>矩阵中起始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回一个长整数矩阵，包含了所读取的数据。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readLongs方法。该方法先验证参数是否有效，然后调用readCore方法来读取数据。</p>
<p>DataStream.readShort</p>
<p>从数据流中读取short值。</p>
<p class="title_2">语法</p>
<p>public short readShort ()。</p>
<p class="title_2">返回值</p>
<p>返回所读取的short值。</p>
<p class="title_2">说明</p>
<p class="title_2">说明该方法实现了IDataStream.readShort方法。该方法调用read方法读取两个字节，然后再转换为短整数。</p>
<p>DataStream.readShorts</p>
<p>从数据流中读取指定数量的短整数放入到short矩阵中。</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>保存读入数据的矩阵。index矩阵中起始位置的索引。</p>
<p class="title_2">返回值</p>
<p>返回一个短整数矩阵，包含了所读取的数据。</p>
<p class="title_2">说明</p>
<p>该方法实现了IDataStream.readShorts方法。该方法先验证参数是否有效，然后调用readCore方法来读取数据。</p>
<p>DataStream.readString</p>
<p>从数据流中读取预定长度的单一码字符串。</p>
<p class="title_2">语法</p>
<p>public String readString ()。</p>
<p class="title_2">返回值</p>
<p>返回所读取的字符串值。</p>
<p class="title_2">说明</p>
<p class="title_2">说明该方法实现了IDataStream.readString方法。</p>
<p>DataStream.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 class="title_2">说明</p>
<p>该方法实现了IDataStream.readStringChars方法。DataStream.readStringCharsAnsi从数据流中读取ANSI字符串。</p>
<p class="title_2">语法</p>
<p>public String readStringCharsAnsi ( int length )</p>