course6.htm

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

<p>该方法先从数据流读取length个字节，然后使用系统缺省代码页将其转换为单一码字符串。结果字符串的长度是代码页的函数，可能比从数据流中读取的字节数小。</p>
<p>请参阅：writeStringCharsAnsi</p>
<p>IDataStream.readStringNull</p>
<p>从数据流中读取以null结尾的单一码字符串。</p>
<p class="title_2">语法</p>
<p>public String readStringNull( )</p>
<p class="title_2">返回值</p>
<p>返回所读取的字符串。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作，就产生IOException异常。</p>
<p>如果在读取字符串时到达了数据流的末尾，就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>该方法不断地从数据流中读取16位的单一码字符，直到遇到一个空字符。所读取的字符（不包括用于结尾的空字符）然后就转换为字符串。</p>
<p>请参阅：writeStringNull</p>
<p>IDataStream.readStringNullAnsi</p>
<p>从数据流中读取以null结尾的ANSI字符串。</p>
<p class="title_2">语法</p>
<p>public String readStringNullAnsi( )</p>
<p class="title_2">返回值</p>
<p>返回所读取的字符串。</p>
<p>异常如果I/O错误或者数据流不支持读操作，就产生IOException异常。</p>
<p>如果在读取字符串时到达了数据流的末尾，就产生EOFException异常。</p>
<p class="title_2">说明</p>
<p>该方法不断地从数据流中读取字节，直到遇到一个空字节。所读取的字节（不包括用于结尾的空字节）然后就转换为字符串。</p>
<p>请参阅：writeStringNullAnsi</p>
<p>IDataStream.readToEnd</p>
<p>将当前指针位置处直到数据流末尾的数据都读入一个字节矩阵中。</p>
<p class="title_2">语法</p>
<p>public byte[] readToEnd ()</p>
<p class="title_2">返回值</p>
<p>返回包含所读取数据的字节矩阵。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持读操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>如果当前的指针就在数据流的开头，则就等同于将所有的数据都读出到一个字节矩阵。如果当前操作成功完成，当前的指针就指向数据流的末尾。</p>
<p>请参阅：IByteStream.read, readBytes</p>
<p>IDataStream.readUTF</p>
<p>使用预定长度UTF-8格式从数据流中读取字符串。</p>
<p class="title_2">语法</p>
<p>public String readUTF()</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>UTF编码的字符串通常比单一码能更有效地利用空间，但处理起来也更费时间。</p>
<p>请参阅：writeUTF</p>
<p>IDataStream.writeBoolean</p>
<p>将boolean值写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeBoolean ( boolean value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的boolean值。</p>
<p class="title_2">异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>向数据流写入一个字节，0代表false，1代表true。</p>
<p>请参阅：readBoolean</p>
<p>IDataStream.writeByte</p>
<p>将一个字节写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeByte (byte value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的字节。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>当前的指针向前移动一个字节。</p>
<p>请参阅：readBytes</p>
<p>IDataStream.writeBytes</p>
<p>将指定字节矩阵的内容写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeBytes ( byte[] buffer )</p>
<p class="title_2">参数</p>
<p>buffer</p>
<p>包含要写入数据的矩阵。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p>请参阅：IByteStream.write, readBytes</p>
<p>IDataStream.writeChar</p>
<p>将一个字符写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeChar (char value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的字符。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>当前的指针向前移动两个字节。</p>
<p>请参阅：readChars</p>
<p>IDataStream.writeChars</p>
<p>将指定字符矩阵的内容写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeChars ( char[] buffer )</p>
<p>public void writeChars ( 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>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>写入数据流的字节数是buffer.length*2。当前指针位置向前移动count*8个字节。</p>
<p>请参阅：readChars</p>
<p>IDataStream.writeDouble</p>
<p>将一个double值写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeDouble (double value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的double值。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>当前的指针向前移动8个字节。</p>
<p>请参阅：readDouble</p>
<p>IDataStream.writeDoubles</p>
<p>将指定double矩阵的内容写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeDoubles ( double[] buffer )</p>
<p>public void writeDoubles ( double[] 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>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>写入数据流的字节数是buffer.length*8。当前指针位置向前移动count*8个字节。</p>
<p>请参阅：readDoubles</p>
<p>IDataStream.writeFloat</p>
<p>将一个float值写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeFloat (float value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的float值。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>当前的指针向前移动4个字节。</p>
<p>请参阅：readFloat</p>
<p>IDataStream.writeFloats</p>
<p>将指定float矩阵的内容写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeFloats ( float[] buffer )</p>
<p>public void writeFloats ( 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>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>写入数据流的字节数是buffer.length*4。当前指针位置向前移动count*4个字节。</p>
<p>请参阅：readFloats</p>
<p>IDataStream.writeInt</p>
<p>将一个整数写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeInt (int value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的整数。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>当前的指针向前移动4个字节。</p>
<p>请参阅：readInts</p>
<p>IDataStream.writeInts</p>
<p>将指定整数矩阵的内容写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeInts ( int[] buffer )</p>
<p>public void writeInts ( 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>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>写入数据流的字节数是buffer.length*4。当前指针位置向前移动count*4个字节。</p>
<p>请参阅：readInts</p>
<p>IDataStream.writeLong</p>
<p>将一个长整数写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeLong (long value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的长整数。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>当前的指针向前移动8个字节。</p>
<p>请参阅：readLong</p>
<p>IDataStream.writeLongs</p>
<p>将指定长整数矩阵的内容写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeLongs ( long[] buffer )</p>
<p>public void writeLongs ( long[] 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>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>写入数据流的字节数是buffer.length*8。当前指针位置向前移动count*8个字节。</p>
<p>请参阅：readLongs</p>
<p>IDataStream.writeShort</p>
<p>将一个短整数写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeShort (short value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的短整数。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>当前的指针向前移动两个字节。</p>
<p>请参阅：readShort</p>
<p>IDataStream.writeShorts</p>
<p>将指定短整数矩阵的内容写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeShorts ( short[] buffer )</p>
<p>public void writeShorts ( short[] 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>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>写入数据流的字节数是buffer.length*2。当前指针位置向前移动count*2个字节。</p>
<p>请参阅：readShorts</p>
<p>IDataStream.writeString</p>
<p>将预定长单一码字符串写入数据流中。</p>
<p class="title_2">语法</p>
<p>public void writeString ( String value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的字符串值。</p>
<p>异常</p>
<p>如果出现I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>该方法先以32位无符号整数的形式写入字符串长度，然后将这么多的16位单一码字符写入字符串中。</p>
<p>请参阅：readString</p>
<p>IDataStream.writeStringChars</p>
<p>向数据流中写入单一码字符串。</p>
<p class="title_2">语法</p>
<p>public void writeStringChars( String value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的字符串值。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持写操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>写入数据流中的单一码字符的数量与字符串的长度相对应。</p>
<p>请参阅：readStringChars</p>
<p>IDataStream.writeStringCharsAnsi</p>
<p>向数据流中写入ANSI字符串。</p>
<p class="title_2">语法</p>
<p>public void writeStringCharsAnsi( String value )</p>
<p class="title_2">参数</p>
<p>value</p>
<p>要写入的字符串值。</p>
<p>异常</p>
<p>如果I/O错误或者数据流不支持写入操作，就产生IOException异常。</p>
<p class="title_2">说明</p>
<p>先使用系统缺省的代码页将指定的字符串转换为字节序列。然后将这些字节写入数据流中。写入数据流的字节数是代码页的函数，有可能比字符串的长度大。</p>
<p>请参阅：readStringCharsAnsi</p>
<p>IDataStream.writeStringNull</p>
<p>向数据流中写入以null结尾的单一码字符串。</p>
<p class="title_2">语法</p>
<p>public void writeStringNull( String value )</p>