包flash.utils
接口public interface IDataOutput
实现器ByteArray, Socket

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

IDataOutput 接口提供一组用于写入二进制数据的方法。 此接口是读取二进制数据的 IDataInput 接口的 I/O 对应接口。 IDataOutput 接口是由 Socket 和 ByteArray 类实现的。

默认情况下，所有 IDataInput 和 IDataOutput 操作均为“bigEndian”（序列中的最高有效字节存储在最低或第一个存储地址），而且都不分块。

符号扩展名仅在读取数据时有效，写入数据时无效。 因此，无需单独的写入方法就可以使用 IDataInput.readUnsignedByte() 和 IDataInput.readUnsignedShort()。 换言之：

查看示例

另请参见

IDataInput interface
endian
Socket class
URLStream class
ByteArray class


公共 属性
 属性定义方
  endian : String
数据的字节顺序，为 Endian 类中的“bigEndian”或“littleEndian”常数。
IDataOutput
  objectEncoding : uint
用于确定在写入或读取二进制数据时应使用 ActionScript 3.0、ActionScript 2.0 还是 ActionScript 1.0 格式。
IDataOutput
公共 方法
 方法定义方
  
writeBoolean(value:Boolean):void
写入布尔值。
IDataOutput
  
writeByte(value:int):void
写入一个字节。
IDataOutput
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
将指定字节数组 bytes（起始偏移量为 bytes，从 0 开始的索引）中包含 length 个字节的字节序列写入字节流。
IDataOutput
  
writeDouble(value:Number):void
写入 IEEE 754 双精度（64 位）浮点数。
IDataOutput
  
writeFloat(value:Number):void
写入 IEEE 754 单精度（32 位）浮点数。
IDataOutput
  
writeInt(value:int):void
写入一个带符号的 32 位整数。
IDataOutput
  
writeMultiByte(value:String, charSet:String):void
使用指定的字符集将多字节字符串写入字节流。
IDataOutput
  
writeObject(object:*):void
以 AMF 序列化格式将一个对象写入字节流或字节数组。
IDataOutput
  
writeShort(value:int):void
写入一个 16 位整数。
IDataOutput
  
writeUnsignedInt(value:uint):void
写入一个无符号的 32 位整数。
IDataOutput
  
writeUTF(value:String):void
将 UTF-8 字符串写入字节流。
IDataOutput
  
writeUTFBytes(value:String):void
写入一个 UTF-8 字符串。
IDataOutput
属性详细信息
endian属性
endian:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

数据的字节顺序，为 Endian 类中的“bigEndian”或“littleEndian”常数。


实现
    public function get endian():String
    public function set endian(value:String):void

另请参见

Endian class
objectEncoding属性 
objectEncoding:uint  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

用于确定在写入或读取二进制数据时应使用 ActionScript 3.0、ActionScript 2.0 还是 ActionScript 1.0 格式。 该值为 ObjectEncoding 类中的常数。


实现
    public function get objectEncoding():uint
    public function set objectEncoding(value:uint):void

另请参见

IDataInput.readObject()
writeObject()
ObjectEncoding class
方法详细信息
writeBoolean()方法
public function writeBoolean(value:Boolean):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入布尔值。 根据 value 参数写入单个字节。如果为 true，则写入 1，如果为 false，则写入 0。

参数

value:Boolean — 确定写入哪个字节的布尔值。 如果该参数为 true，Flash Player 将写入 1；如果为 false，Flash Player 将写入 0。

writeByte()方法 
public function writeByte(value:int):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入一个字节。 使用参数的低 8 位。 忽略高 24 位。

参数

value:int — 一个整型字节值。

writeBytes()方法 
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

将指定字节数组 bytes（起始偏移量为 offset，从零开始的索引）中包含 length 个字节的字节序列写入字节流。

如果省略 length 参数，则使用默认长度 0；Flash Player 从 offset 开始写入整个缓冲区。 如果还省略了 offset 参数，则写入整个缓冲区。

如果 offset 或 length 参数超出范围，它们将被锁定到 bytes 数组的开头和结尾。

参数

bytes:ByteArray — 要写入的字节数组。
 
offset:uint (default = 0) — 从 0 开始的索引，表示在数组中开始写入的位置。
 
length:uint (default = 0) — 一个无符号整数，表示在缓冲区中的写入范围。

writeDouble()方法 
public function writeDouble(value:Number):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入 IEEE 754 双精度（64 位）浮点数。

参数

value:Number — 双精度（64 位）浮点数。

writeFloat()方法 
public function writeFloat(value:Number):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入 IEEE 754 单精度（32 位）浮点数。

参数

value:Number — 单精度（32 位）浮点数。

writeInt()方法 
public function writeInt(value:int):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入一个带符号的 32 位整数。

参数

value:int — 一个带符号的整型字节值。

writeMultiByte()方法 
public function writeMultiByte(value:String, charSet:String):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

使用指定的字符集将多字节字符串写入字节流。

参数

value:String — 要写入的字符串值。
 
charSet:String — 指示要使用的字符集的字符串。 可能的字符集字符串包括 "shift-jis"、"cn-gb"、"iso-8859-1" 等。 有关完整列表，请参阅Supported Character Sets。

writeObject()方法 
public function writeObject(object:*):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

以 AMF 序列化格式将一个对象写入字节流或字节数组。

参数

object:* — 要序列化的对象

另请参见

objectEncoding
writeShort()方法 
public function writeShort(value:int):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入一个 16 位整数。 使用参数的低 16 位。 忽略高 16 位。

参数

value:int — 一个整型字节值。

writeUnsignedInt()方法 
public function writeUnsignedInt(value:uint):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入一个无符号的 32 位整数。

参数

value:uint — 一个无符号的整型字节值。

writeUTF()方法 
public function writeUTF(value:String):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

将 UTF-8 字符串写入字节流。 先写入以字节表示的 UTF-8 字符串长度（作为 16 位整数），然后写入表示字符串字符的字节。

参数

value:String — 要写入的字符串值。


引发
RangeError — 如果长度大于 65535。
writeUTFBytes()方法 
public function writeUTFBytes(value:String):void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

写入一个 UTF-8 字符串。 类似于 writeUTF()，但不使用 16 位长度的词为字符串添加前缀。

参数

value:String — 要写入的字符串值。

示例 如何使用示例

以下示例使用 DataOutputExample 类将布尔值和 pi 的双精度浮点表示形式写入字节数组。 这是使用以下步骤完成的：
  1. 声明新的 ByteArray 对象实例 byteArr。
  2. 写入布尔值 false 的字节等效值和数学值 pi 的双精度浮点等效值。
  3. 重新读取布尔值和双精度浮点数。

注意如何在末尾添加一段代码以检查文件结尾错误，确保读取的字节流没有超出文件结尾。

package {
    import flash.display.Sprite;
    import flash.utils.ByteArray;
    import flash.errors.EOFError;

    public class DataOutputExample extends Sprite {        
        public function DataOutputExample() {
            var byteArr:ByteArray = new ByteArray();

            byteArr.writeBoolean(false);
            byteArr.writeDouble(Math.PI);
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean()); // false
            } 
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
                        
            try {
                trace(byteArr.readDouble());    // 3.141592653589793
            } 
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
            
            try {
                trace(byteArr.readDouble());
            } 
            catch(e:EOFError) {
                trace(e);        // EOFError: Error #2030: End of file was encountered.
            }
        }
    }
}



© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Wed Jun 13 2007, 3:54 AM GMT-07:00

 

评论添加到页面后给我发送电子邮件 | 评论报告

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/utils/IDataOutput.html