| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
ByteArray クラスには、バイナリデータの読み取り、書き込み、および操作を最適化するメソッドおよびプロパティがあります。
メモ : ByteArray クラスは、バイトレベルでデータにアクセスする必要がある上級の ActionScript 開発者を対象としています。
メモリ内データはバイトの詰め込み配列 (最もコンパクトなデータ型の表現) ですが、標準 ActionScript [] (配列アクセス) 演算子を使用すると ByteArray クラスのインスタンスを操作できます。また、URLStream および Socket クラスと同じメソッドを使用すると、メモリ内ファイルとして読み取りおよび書き取りをすることができます。
さらに、AMF (Action Message Format) オブジェクトの直列化に加えて、zlib 圧縮および解凍もサポートされています。
ByteArray クラスを使用すると、以下の操作が可能です。
- カスタム プロトコルを作成してサーバーに接続
- 独自の URLEncoder および URLDecoder の作成
- 独自の AMF および Remoting パケットの作成
- データ型を使用したデータのサイズの最適化
例を表示
bytesAvailable:uint [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイト配列の現在の位置から最後まで読み取り可能なデータのバイト数です。
ByteArray オブジェクトにアクセスするたびに、読み取りメソッドと共に bytesAvailable プロパティを使用すると、有効なデータが読み取られていることを確認できます。
実装
public function get bytesAvailable():uint
defaultObjectEncoding:uint [read-write]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
新しい ByteArray インスタンスに使用する ByteArray クラス用のデフォルトオブジェクトのエンコードを表します。新しい ByteArray インスタンスを作成すると、そのインスタンスのエンコードが defaultObjectEncoding の値で開始します。defaultObjectEncoding プロパティは ObjectEncoding.AMF3 に初期化されます。
バイナリデータからオブジェクトの書き込みまたは読み取りをすると、objectEncoding 値を使用して、ActionScript 3.0、ActionScript 2.0、または ActionScript 1.0 の形式を使用する必要があるかどうかが特定されます。この値は、ObjectEncoding クラスの定数です。
実装
public static function get defaultObjectEncoding():uint
public function set defaultObjectEncoding(value:uint):void
関連項目
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
関連項目
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:uint [read-write]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
ByteArray インスタンスへの書き込み、または ByteArray インスタンスからの読み取り時の、ActionScript 3.0、ActionScript 2.0、または ActionScript 1.0 の形式を使用する必要があるかどうかの特定に使用されます。この値は、ObjectEncoding クラスの定数です。
実装
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
関連項目
position:uint [read-write]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
ByteArray オブジェクトにファイルポインタの現在の位置をバイト単位で移動するかまたは返します。これは、次に読み取りメソッドを呼び出して読み取りを開始するポイント、または書き出しメソッドで書き出しを開始するポイントです。
実装
public function get position():uint
public function set position(value:uint):void
public function ByteArray()
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトの詰め込み配列を表す ByteArray インスタンスを作成します。その結果、このクラスでメソッドおよびプロパティを使用すると、データストレージおよびデータストリームを最適化できます。
public function compress():void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
zlib 圧縮データ形式を使用してバイト配列を圧縮します。バイト配列全体が圧縮されます。
呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティがバイト配列の末尾に設定されます。
zlib 圧縮データ形式の詳細については、http://www.ietf.org/rfc/rfc1950.txt の説明を参照してください。
関連項目
public function readBoolean():Boolean
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームからブール値を読み取ります。1 バイトが読み取られ、バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。
戻り値
| Boolean — バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。
|
例外
public function readByte():int
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから符号付きバイトを読み取ります。
戻り値は -128 ~ 127 の範囲です。
戻り値
例外
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから、length パラメータで指定したデータバイト数を読み取ります。バイトは、bytes パラメータによって指定された ByteArray オブジェクトに読み取られ、offset によって指定された位置から始まるターゲット ByteArray に書き込まれます。
パラメータ
| bytes:ByteArray — データの読み込み先の ByteArray オブジェクトです。
|
| |
| offset:uint (default = 0) — 読み取ったデータが書き込まれる bytes 内のオフセット (位置) です。
|
| |
| length:uint (default = 0) — 読み取るバイト数です。デフォルト値の 0 に設定すると、すべてのデータが読み取られます。
|
例外
public function readDouble():Number
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから IEEE 754 倍精度 (64 ビット) 浮動小数点数を読み取ります。
戻り値
| Number — 倍精度 (64 ビット) 浮動小数点数です。
|
例外
public function readFloat():Number
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから IEEE 754 単精度 (32 ビット) 浮動小数点数を読み取ります。
戻り値
| Number — 単精度 (32 ビット) 浮動小数点数です。
|
例外
public function readInt():int
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから符号付き 32 ビット整数を読み取ります。
戻り値は -2147483648 ~ 2147483647 の範囲です。
戻り値
| int — -2147483648 ~ 2147483647 の 32 ビット符号付き整数です。
|
例外
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" などがあります。完全な一覧については、「サポートする文字セット」を参照してください。
メモ: charSet パラメータの値が現在のシステムによって認識されない場合、Flash Player はシステムのデフォルトコードページを文字セットとして使用します。たとえば、charSet パラメータの指定で 1 の代わりに 01 を使用して myTest.readMultiByte(22, "iso-8859-01") というような指定を行った場合、その文字セットパラメータは開発マシンでは認識されるかもしれませんが、別のマシンでは認識されない可能性があります。もう一方のマシンでは、Flash Player がシステムのデフォルトコードページを使用することになります。
|
戻り値
| String — UTF-8 エンコードされたストリングです。
|
例外
public function readObject():*
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイト配列から AMF 直列化形式でエンコードされたオブジェクトを読み取ります。
戻り値
例外
public function readShort():int
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから符号付き 16 ビット整数を読み取ります。
戻り値は -32768 ~ 32767 の範囲です。
戻り値
| int — -32768 ~ 32767 の 16 ビット符号付き整数です。
|
例外
public function readUnsignedByte():uint
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから符号なしバイトを読み取ります。
戻り値は 0 ~ 255 の範囲です。
戻り値
| uint — 0 ~ 255 の 32 ビット符号なし整数です。
|
例外
public function readUnsignedInt():uint
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから符号なし 32 ビット整数を読み取ります。
戻り値は 0 ~ 4294967295 の範囲です。
戻り値
| uint — 0 ~ 4294967295 の 32 ビット符号なし整数です。
|
例外
public function readUnsignedShort():uint
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから符号なし 16 ビット整数を読み取ります。
戻り値は 0 ~ 65535 の範囲です。
戻り値
| uint — 0 ~ 65535 の 16 ビット符号なし整数です。
|
例外
public function readUTF():String
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから UTF-8 ストリングを読み取ります。このストリングには、バイト単位で長さを示す符号なし short が接頭辞として付くことが前提となっています。
戻り値
| String — UTF-8 エンコードされたストリングです。
|
例外
関連項目
public function readUTFBytes(length:uint):String
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームから、length パラメータで指定した UTF-8 バイトのシーケンスを読み取り、ストリングを返します。
パラメータ
| length:uint — UTF-8 バイトの長さを示す符号なし short です。
|
戻り値
| String — 指定した長さの UTF-8 バイトで構成するストリングです。
|
例外
public function toString():String
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイト配列をストリングに変換します。配列のデータが Unicode バイト順マークで開始する場合、Flash ではストリングの変換時に、そのマークは使用されません。System.useCodePage を true に設定すると、Player では、変換時の配列は現在のシステムコードページにあると見なされます。
戻り値
public function uncompress():void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイト配列を解凍します。バイト配列は、zlib 圧縮データ形式を使用して圧縮済みである必要があります。
呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティが 0 に設定されます。
zlib 圧縮データ形式の詳細については、http://www.ietf.org/rfc/rfc1950.txt の説明を参照してください。
関連項目
public function writeBoolean(value:Boolean):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
ブール値を書き込みます。value パラメータに従って、1 バイトが書き込まれます。true の場合は 1、false の場合は 0 のいずれかが書き込まれます。
パラメータ
| value:Boolean — 書き込むバイトを決定するブール値です。このパラメータが true の場合は 1、false の場合は 0 が Flash Player によって書き込まれます。
|
public function writeByte(value:int):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームにバイトを書き込みます。
パラメータの下位 8 ビットが使用されます。上位 24 ビットは無視されます。
パラメータ
| value:int — 32 ビット整数です。バイトストリームに下位 8 ビットが書き込まれます。
|
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
指定したバイト配列の offset (0 から始まるインデックス値) バイトから開始される length バイトのシーケンス bytes をバイトストリームに書き込みます。
length パラメータを省略すると、デフォルトの長さの 0 が使用され、Flash Player によって offset から開始されるバッファ全体が書き込まれます。offset パラメータも省略した場合は、バッファ全体が書き込まれます。
offset または length が範囲外の場合、これらは bytes 配列の最初と最後に固定されます。
パラメータ
| bytes:ByteArray — ByteArray オブジェクトです。
|
| |
| offset:uint (default = 0) — 書き込みを開始する配列への位置を示す 0 から始まるインデックスです。
|
| |
| length:uint (default = 0) — 書き込むバッファまでの距離を示す符号付きの整数です。
|
public function writeDouble(value:Number):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームに IEEE 754 倍精度 (64 ビット) 浮動小数点数を書き込みます。
パラメータ
| value:Number — 倍精度 (64 ビット) 浮動小数点数です。
|
public function writeFloat(value:Number):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームに IEEE 754 単精度 (32 ビット) 浮動小数点数を書き込みます。
パラメータ
| value:Number — 単精度 (32 ビット) 浮動小数点数です。
|
public function writeInt(value:int):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームに 32 ビット符号付き整数を書き込みます。
パラメータ
| value:int — バイトストリームに書き込む整数です。
|
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" などがあります。完全な一覧については、「サポートする文字セット」を参照してください。
|
public function writeObject(object:*):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイト配列に AMF 直列化形式でオブジェクトを書き込みます。
パラメータ
| object:* — 並列化するオブジェクトです。
|
public function writeShort(value:int):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームに 16 ビット整数を書き込みます。パラメータの下位 16 ビットが使用されます。上位 16 ビットは無視されます。
パラメータ
| value:int — バイトストリームに下位 16 ビットが書き込まれる 32 ビット整数です。
|
public function writeUnsignedInt(value:uint):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームに 32 ビット符号なし整数を書き込みます。
パラメータ
| value:uint — バイトストリームに書き込む符号なし整数です。
|
public function writeUTF(value:String):void
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
バイトストリームに UTF-8 ストリングを書き込みます。最初に UTF-8 ストリングの長さがバイト単位で 16 ビット整数として書き込まれ、その後にストリングの文字を表すバイトが続きます。
パラメータ
| value:String — 書き込まれるストリング値です。
|
例外
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 の平方根と等価の倍精度の浮動小数を書き込みます。
- バイト配列に書き込まれた各 9 バイトを戻します。
メモ : trace() がバイトに対して呼び出されると、バイト配列に保存された 10 進表現のバイトが出力されます。
コードセグメントが最後に追加され、ファイルの終端エラーをチェックして、バイトストリームが最後まで読み取られないことを確認します。
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.
}
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Thu Oct 25 2007, 12:41 AM GMT-07:00
現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/flash/utils/ByteArray.html