flash.utils.ByteArray (ActionScript 3.0)

	属性	定义方
		bytesAvailable : uint [read-only] 可从字节数组的当前位置到数组末尾读取的数据的字节数。	ByteArray
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		defaultObjectEncoding : uint [static] 指示用于新 ByteArray 实例的 ByteArray 类的默认对象编码。	ByteArray
		endian : String 更改或读取数据的字节顺序：“bigEndian”或“littleEndian”。	ByteArray
		length : uint ByteArray 对象的长度（以字节为单位）。	ByteArray
		objectEncoding : uint 用于确定在写入或读取 ByteArray 实例时应使用 ActionScript 3.0、ActionScript 2.0 还是 ActionScript 1.0 格式。	ByteArray
		position : uint 将文件指针的当前位置（以字节为单位）移动或返回到 ByteArray 对象中。	ByteArray
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object

	方法	定义方
		ByteArray() 创建一个表示填充的字节数组的 ByteArray 实例，以便使用此类中的方法和属性来优化数据存储和数据流。	ByteArray
		compress():void 使用 zlib 压缩方法压缩字节数组。	ByteArray
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		readBoolean():Boolean 从字节流中读取布尔值。	ByteArray
		readByte():int 从字节流中读取带符号的字节。	ByteArray
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void 从字节流中读取 length 参数指定的数据字节数。	ByteArray
		readDouble():Number 从字节流中读取一个 IEEE 754 双精度（64 位）浮点数。	ByteArray
		readFloat():Number 从字节流中读取一个 IEEE 754 单精度（32 位）浮点数。	ByteArray
		readInt():int 从字节流中读取一个带符号的 32 位整数。	ByteArray
		readMultiByte(length:uint, charSet:String):String 使用指定的字符集从字节流中读取指定长度的多字节字符串。	ByteArray
		readObject():* 从字节数组中读取一个以 AMF 序列化格式进行编码的对象。	ByteArray
		readShort():int 从字节流中读取一个带符号的 16 位整数。	ByteArray
		readUnsignedByte():uint 从字节流中读取无符号的字节。	ByteArray
		readUnsignedInt():uint 从字节流中读取一个无符号的 32 位整数。	ByteArray
		readUnsignedShort():uint 从字节流中读取一个无符号的 16 位整数。	ByteArray
		readUTF():String 从字节流中读取一个 UTF-8 字符串。	ByteArray
		readUTFBytes(length:uint):String 从字节流中读取一个由 length 参数指定的 UTF-8 字节序列，并返回一个字符串。	ByteArray
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 将字节数组转换为字符串。	ByteArray
		uncompress():void 解压缩字节数组。	ByteArray
		valueOf():Object 返回指定对象的原始值。	Object
		writeBoolean(value:Boolean):void 写入布尔值。	ByteArray
		writeByte(value:int):void 在字节流中写入一个字节。	ByteArray
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void 将指定字节数组 bytes（起始偏移量为 bytes，从 0 开始的索引）中包含 length 个字节的字节序列写入字节流。	ByteArray
		writeDouble(value:Number):void 在字节流中写入一个 IEEE 754 双精度（64 位）浮点数。	ByteArray
		writeFloat(value:Number):void 在字节流中写入一个 IEEE 754 单精度（32 位）浮点数。	ByteArray
		writeInt(value:int):void 在字节流中写入一个带符号的 32 位整数。	ByteArray
		writeMultiByte(value:String, charSet:String):void 使用指定的字符集将多字节字符串写入字节流。	ByteArray
		writeObject(object:*):void 将对象以 AMF 序列化格式写入字节数组。	ByteArray
		writeShort(value:int):void 在字节流中写入一个 16 位整数。	ByteArray
		writeUnsignedInt(value:uint):void 在字节流中写入一个无符号的 32 位整数。	ByteArray
		writeUTF(value:String):void 将 UTF-8 字符串写入字节流。	ByteArray
		writeUTFBytes(value:String):void 将 UTF-8 字符串写入字节流。	ByteArray

属性详细信息

bytesAvailable

属性

bytesAvailable:uint [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

可从字节数组的当前位置到数组末尾读取的数据的字节数。

每次访问 ByteArray 对象时，将 bytesAvailable 属性与读取方法结合使用，以确保读取有效的数据。

实现
public function get bytesAvailable():uint

defaultObjectEncoding

属性

defaultObjectEncoding:uint [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

指示用于新 ByteArray 实例的 ByteArray 类的默认对象编码。在创建新的 ByteArray 实例时，该实例上的编码以 defaultObjectEncoding 的值开头。 defaultObjectEncoding 属性被初始化为 ObjectEncoding.AMF3。

将对象写入二进制数据或从中读取对象时，将使用 objectEncoding 值来确定应使用 ActionScript 3.0、ActionScript2.0 还是 ActionScript 1.0 格式。该值为 ObjectEncoding 类中的常数。

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

另请参见

ObjectEncoding class
flash.utils.ByteArray.objectEncoding

endian

属性

endian:String [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

更改或读取数据的字节顺序：“bigEndian”或“littleEndian”。这些值是 Endian 类中的常量。

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

另请参见

Endian class

length

属性

length:uint [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

ByteArray 对象的长度（以字节为单位）。

如果长度设置为大于当前长度的值，Flash Player 将在右侧填充零。

如果长度设置为小于当前长度的值，数组将被截断。

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

objectEncoding

属性

objectEncoding:uint [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

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

另请参见

ObjectEncoding class
flash.utils.ByteArray.defaultObjectEncoding

position

属性

position:uint [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

将文件指针的当前位置（以字节为单位）移动或返回到 ByteArray 对象中。下一次调用读取方法时将在此位置开始读取，或者下一次调用写入方法时将在此位置开始写入。

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

构造函数详细信息

ByteArray

()

构造函数

public function ByteArray()

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

创建一个表示填充的字节数组的 ByteArray 实例，以便使用此类中的方法和属性来优化数据存储和数据流。

方法详细信息

compress

()

方法

public function compress():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

使用 zlib 压缩方法压缩字节数组。将压缩整个字节数组。

另请参见

flash.utils.ByteArray.uncompress()

readBoolean

()

方法

public function readBoolean():Boolean

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取布尔值。读取单个字节，如果字节非零，则返回 true，否则返回 false。

Boolean — 如果字节不为零，则返回 true，否则返回 false。

引发

EOFError — 没有足够的数据可供读取。

readByte

()

方法

public function readByte():int

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取带符号的字节。

返回值的范围是从 -128 到 127。

int — 介于 -128 和 127 之间的整数。

引发

EOFError — 没有足够的数据可供读取。

readBytes

()

方法

public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取 length 参数指定的数据字节数。从 offset 指定的位置开始将字节读入 bytes 参数指定的 ByteArray 对象。

参数

	`bytes:ByteArray` — 要将数据读入的 ByteArray 对象。

	`offset:uint` (default = `0`) — `bytes` 中的偏移，应从该位置开始读取数据。

	`length:uint` (default = `0`) — 要读取的字节数。默认值 0 导致读取所有可用的数据。

引发

EOFError — 没有足够的数据可供读取。

readDouble

()

方法

public function readDouble():Number

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个 IEEE 754 双精度（64 位）浮点数。

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

引发

EOFError — 没有足够的数据可供读取。

readFloat

()

方法

public function readFloat():Number

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个 IEEE 754 单精度（32 位）浮点数。

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

引发

EOFError — 没有足够的数据可供读取。

readInt

()

方法

public function readInt():int

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个带符号的 32 位整数。

返回值的范围是从 -2147483648 到 2147483647。

int — 介于 -2147483648 和 2147483647 之间的 32 位带符号整数。

引发

EOFError — 没有足够的数据可供读取。

readMultiByte

()

方法

public function readMultiByte(length:uint, charSet:String):String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

使用指定的字符集从字节流中读取指定长度的多字节字符串。

参数

	`length:uint` — 要从字节流中读取的字节数。

	`charSet:String` — 表示用于解释字节的字符集的字符串。可能的字符集字符串包括 `"shift-jis"`、`"cn-gb"`、`"iso-8859-1"`”等。有关完整列表，请参阅Supported Character Sets。注意：如果当前系统无法识别 `charSet` 参数的值，则 Flash Player 将采用系统的默认代码页作为字符集。例如，`charSet` 参数的值（如在使用 `01` 而不是 `1` 的 `myTest.readMultiByte(22, "iso-8859-01")` 中）可能在您的开发计算机上起作用，但在其它计算机上可能不起作用。在另一台计算机上，Flash Player 将使用系统的默认代码页。

String — UTF-8 编码的字符串。

引发

EOFError — 没有足够的数据可供读取。

readObject

()

方法

public function readObject():*

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节数组中读取一个以 AMF 序列化格式进行编码的对象。

* — 反序列化的对象。

引发

EOFError — 没有足够的数据可供读取。

readShort

()

方法

public function readShort():int

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个带符号的 16 位整数。

返回值的范围是从 -32768 到 32767。

int — 介于 -32768 和 32767 之间的 16 位带符号整数。

引发

EOFError — 没有足够的数据可供读取。

readUnsignedByte

()

方法

public function readUnsignedByte():uint

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取无符号的字节。

返回值的范围是从 0 到 255。

uint — 介于 0 和 255 之间的 32 位无符号整数。

引发

EOFError — 没有足够的数据可供读取。

readUnsignedInt

()

方法

public function readUnsignedInt():uint

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个无符号的 32 位整数。

返回值的范围是从 0 到 4294967295。

uint — 介于 0 和 4294967295 之间的 32 位无符号整数。

引发

EOFError — 没有足够的数据可供读取。

readUnsignedShort

()

方法

public function readUnsignedShort():uint

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个无符号的 16 位整数。

返回值的范围是从 0 到 65535。

uint — 介于 0 和 65535 之间的 16 位无符号整数。

引发

EOFError — 没有足够的数据可供读取。

readUTF

()

方法

public function readUTF():String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个 UTF-8 字符串。假定字符串的前缀是无符号的短整型（以字节表示长度）。

String — UTF-8 编码的字符串。

引发

EOFError — 没有足够的数据可供读取。

另请参见

flash.utils.IDataInput.readUTF()

readUTFBytes

()

方法

public function readUTFBytes(length:uint):String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从字节流中读取一个由 length 参数指定的 UTF-8 字节序列，并返回一个字符串。

参数

length:uint — 指明 UTF-8 字节长度的无符号短整型数。

String — 由指定长度的 UTF-8 字节组成的字符串。

引发

EOFError — 没有足够的数据可供读取。

toString

()

方法

public function toString():String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

将字节数组转换为字符串。如果数组中的数据以 Unicode 字节顺序标记开头，Flash 在转换为字符串时将保持该标记。如果 System.useCodePage 设置为 true，播放器在转换时会将数组中的数据视为处于当前系统代码页中。

String — 字节数组的字符串表示形式。

uncompress

()

方法

public function uncompress():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

解压缩字节数组。字节数组必须事先使用 compress() 方法压缩过。

另请参见

flash.utils.ByteArray.compress()

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 — 一个 32 位整数。低 8 位将被写入字节流。

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` — 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:* — 要序列化的对象。

writeShort

()

方法

public function writeShort(value:int):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

在字节流中写入一个 16 位整数。使用参数的低 16 位。忽略高 16 位。

参数

value:int — 32 位整数，该整数的低 16 位将被写入字节流。

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() 方法，但 writeUTFBytes() 不使用 16 位长度的词为字符串添加前缀。

参数

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

示例如何使用示例

以下示例使用 ByteArrayExample 类将布尔值和 pi 的双精度浮点表示形式写入字节数组。这是使用以下步骤完成的：

声明新的 ByteArray 对象实例 byteArr。
写入布尔值 false 的字节等效值，然后检查长度并重新读取。
写入数学值 pi 的双精度浮点等效值。
重新读取写入字节数组的九个字节中的每一个字节。

注意：在字节上调用 trace() 时，它将输出存储于字节数组中的字节的十进制等效值。

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

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

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

            byteArr.writeBoolean(false);
            trace(byteArr.length);            // 1
            trace(byteArr[0]);            // 0

            byteArr.writeDouble(Math.PI);
            trace(byteArr.length);            // 9
            trace(byteArr[0]);            // 0
            trace(byteArr[1]);            // 64
            trace(byteArr[2]);            // 9
            trace(byteArr[3]);            // 33
            trace(byteArr[4]);            // 251
            trace(byteArr[5]);            // 84
            trace(byteArr[6]);            // 68
            trace(byteArr[7]);            // 45
            trace(byteArr[8]);            // 24
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean() == false); // true
            } 
            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.
            }
        }
    }
}

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

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
ByteArray	属性 \| 方法 \| 示例

包	flash.utils
类	public class ByteArray
继承	ByteArray Object
实现	IDataInput, IDataOutput