バイト配列の現在の位置から最後までの読み取り可能なデータのバイト数です。

ByteArray オブジェクトにアクセスするたびに bytesAvailable プロパティと読み取りメソッドを組み合わせて使用すれば、有効なデータを確実に読み取ることができます。

新しい ByteArray インスタンスに使用する ByteArray クラス用のデフォルトオブジェクトのエンコードを表します。新しい ByteArray インスタンスを作成すると、そのインスタンスのエンコードが defaultObjectEncoding の値で開始します。 defaultObjectEncoding プロパティは ObjectEncoding.AMF3 に初期化されます。

バイナリデータからオブジェクトの書き込みまたは読み取りをすると、objectEncoding 値を使用して、ActionScript 3.0、ActionScript 2.0、または ActionScript 1.0 の形式を使用する必要があるかどうかが特定されます。この値は、ObjectEncoding クラスの定数です。

関連項目

データのバイト順序（Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN）を変更するか、読み取ります。

関連項目

ByteArray オブジェクトのバイト単位の長さです。

この長さに現在の長さよりも大きい値を設定すると、バイト配列の右側は 0 で埋められます。

この長さに現在の長さよりも小さい値を設定すると、バイト配列は切り詰められます。

ByteArray インスタンスへの書き込み、または ByteArray インスタンスからの読み取り時の、ActionScript 3.0、ActionScript 2.0、または ActionScript 1.0 の形式を使用する必要があるかどうかの特定に使用されます。この値は、ObjectEncoding クラスの定数です。

関連項目

ByteArray オブジェクト内でのファイルポインタの現在の位置をバイト単位で移動するか、または現在の位置をバイト単位で返します。これは、次に読み取りメソッドまたは書き込みメソッドを呼び出したときに読み取りまたは書き込みが開始されるポイントです。

バイトの詰め込み配列を表す ByteArray インスタンスを作成します。これにより、このクラスのメソッドおよびプロパティを使用して、データストレージおよびデータストリームを最適化できます。

バイト配列の内容を消去し、長さと位置のプロパティを 0 にリセットします。このメソッドを明示的に呼び出すと、ByteArray インスタンスによって使用されるメモリを解放します。

バイト配列を圧縮します。バイト配列全体が圧縮されます。Adobe AIR で実行しているコンテンツの場合、CompressionAlgorithm クラスに定義されている値を algorithm パラメータとして渡すことにより、圧縮アルゴリズムを指定できます。Flash Player は、デフォルトの zlib アルゴリズムのみをサポートします。

呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティがバイト配列の末尾に設定されます。

zlib 圧縮データ形式の詳細については、http://www.ietf.org/rfc/rfc1950.txt の説明を参照してください。

deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。

deflate 圧縮アルゴリズムは、zlib、gzip、一部の zip 実装などの様々な圧縮形式で使用されています。これらの圧縮形式のいずれかを使用してデータを圧縮した場合、その圧縮形式データ（.zip ファイルなど）には、元のデータの圧縮されたバージョンに加えてメタデータ情報も保存されます。各種ファイル形式に含まれるメタデータの種類の例としては、ファイル名、ファイル修正日時、元のファイルサイズ、オプションのコメント、チェックサムデータなどがあります。

例えば、zlib アルゴリズムを使用して ByteArray を圧縮すると、生成された ByteArray の構造はある特定のフォーマットになります。特定のバイト位置に圧縮データに関するメタデータが格納され、それ以外のバイト位置に元の ByteArray データの実際に圧縮されたバージョンが格納されます。zlib 圧縮データ形式の仕様で規定されているように、このバイト部分（つまり、元のデータの圧縮されたバージョンを含む部分）は deflate アルゴリズムを使用して圧縮されます。したがって、これらのバイトは、元の ByteArray で compress( CompressionAlgorithm.DEFLATE) を呼び出した結果と同じです。ただし、 compress( CompressionAlgorithm.ZLIB) の結果には追加のメタデータが含まれています。それに対して、compress(CompressionAlgorithm.DEFLATE) の結果には元の ByteArray データの圧縮されたバージョン以外のものは含まれていません。

したがって、deflate 形式を使用して ByteArray インスタンスのデータを gzip や zip などの特定の形式に圧縮する場合は、単に compress(CompressionAlgorithm.DEFLATE) を呼び出すだけでは不十分です。圧縮形式の仕様に従い、適切なメタデータと deflate 形式で圧縮されたデータで構成された ByteArray を作成する必要があります。同様に、gzip や zip などの形式で圧縮されたデータを解凍する場合、単にそのデータに対して uncompress(CompressionAlgorithm.DEFLATE) を呼び出すだけでは不十分です。まず、圧縮データからメタデータを分離してから、deflate 形式を使用して圧縮データを解凍する必要があります。

パラメータ

関連項目

deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。バイト配列全体が圧縮されます。

呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティがバイト配列の末尾に設定されます。

deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。

deflate 形式を使用して ByteArray インスタンスのデータを gzip や zip などの特定の形式に圧縮する場合は、単に deflate() を呼び出すだけでは目的を達することはできません。圧縮形式の仕様に従い、適切なメタデータと deflate 形式で圧縮されたデータで構成された ByteArray を作成する必要があります。 同様に、gzip や zip などの形式で圧縮されたデータを解凍する場合、単にそのデータに対して inflate() を呼び出すだけでは不十分です。まず、圧縮データからメタデータを分離してから、deflate 形式を使用して圧縮データを解凍する必要があります。

関連項目

deflate 圧縮アルゴリズムを使用してバイト配列を解凍します。同じアルゴリズムを使用してバイト配列が圧縮されている必要があります。

呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティが 0 に設定されます。

deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。

deflate 圧縮アルゴリズムを使用する形式で圧縮されたデータ（gzip 形式や zip 形式のデータ）を解凍する場合、圧縮形式データを含む ByteArray に対して単に inflate() を呼び出してもデータは解凍されません。まず、圧縮データ形式の構成要素であるメタデータを実際の圧縮データから分離する必要があります。詳細については、compress() メソッドの説明を参照してください。

関連項目

バイトストリームからブール値を読み取ります。1 バイトが読み取られ、バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。

バイトストリームから符号付きバイトを読み取ります。

戻り値は -128 ～ 127 の範囲です。

バイトストリームから、length パラメータで指定したデータバイト数を読み取ります。バイトは、bytes パラメータによって指定された ByteArray オブジェクトに読み取られ、offset によって指定された位置から始まるターゲット ByteArray に書き込まれます。

パラメータ

バイトストリームから IEEE 754 倍精度（64 ビット）浮動小数点数を読み取ります。

バイトストリームから IEEE 754 単精度（32 ビット）浮動小数点数を読み取ります。

バイトストリームから符号付き 32 ビット整数を読み取ります。

戻り値は -2147483648 ～ 2147483647 の範囲です。

指定した文字セットを使用して、バイトストリームから指定した長さのマルチバイトストリングを読み取ります。

パラメータ

バイト配列から AMF 直列化形式でエンコードされたオブジェクトを読み取ります。

関連項目

バイトストリームから符号付き 16 ビット整数を読み取ります。

戻り値は -32768 ～ 32767 の範囲です。

バイトストリームから符号なしバイトを読み取ります。

戻り値は 0 ～ 255 の範囲です。

バイトストリームから符号なし 32 ビット整数を読み取ります。

戻り値は 0 ～ 4294967295 の範囲です。

バイトストリームから符号なし 16 ビット整数を読み取ります。

戻り値は 0 ～ 65535 の範囲です。

バイトストリームから UTF-8 ストリングを読み取ります。このストリングには、バイト単位の長さを示す符号なし short が前に付いているものと見なされます。

関連項目

バイトストリームまたはバイト配列から、length パラメータで指定した UTF-8 バイトのシーケンスを読み取り、ストリングを返します。

パラメータ

バイト配列をストリングに変換します。配列のデータが Unicode バイト順マークで開始する場合、アプリケーションではストリングの変換時に、そのマークが使用されます。System.useCodePage を true に設定すると、アプリケーションでは、変換時の配列のデータは現在のシステムコードページにあると見なされます。

バイト配列を解凍します。Adobe AIR で実行しているコンテンツの場合、CompressionAlgorithm クラスに定義されている値を algorithm パラメータとして渡すことにより、圧縮アルゴリズムを指定できます。同じアルゴリズムを使用してバイト配列が圧縮されている必要があります。Flash Player は、デフォルトの zlib アルゴリズムのみをサポートします。

呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティが 0 に設定されます。

zlib 圧縮データ形式の詳細については、http://www.ietf.org/rfc/rfc1950.txt の説明を参照してください。

deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。

deflate 圧縮アルゴリズムを使用する形式で圧縮されたデータ（gzip 形式や zip 形式のデータ）を解凍する場合、圧縮形式データを含む ByteArray に対して uncompress(CompressionAlgorithm.DEFLATE) を呼び出してもデータは解凍されません。まず、圧縮データ形式の構成要素であるメタデータを実際の圧縮データから分離する必要があります。詳細については、compress() メソッドの説明を参照してください。

パラメータ

関連項目

ブール値を書き込みます。 value パラメータに従って、1 バイトが書き込まれます。true の場合は 1、false の場合は 0 のいずれかが書き込まれます。

パラメータ

バイトストリームにバイトを書き込みます。

パラメータの下位 8 ビットが使用されます。上位 24 ビットは無視されます。

パラメータ

指定したバイト配列の length バイトのシーケンス bytes の、offset（0 から始まるインデックス値）バイト以降をバイトストリームに書き込みます。

length パラメータを省略すると、デフォルトの長さの 0 が使用され、メソッドによって offset から開始されるバッファ全体が書き込まれます。 offset パラメータも省略した場合は、バッファ全体が書き込まれます。

offset または length が範囲外の場合、これらは bytes 配列の最初と最後に固定されます。

パラメータ

バイトストリームに IEEE 754 倍精度（64 ビット）浮動小数点数を書き込みます。

パラメータ

バイトストリームに IEEE 754 単精度（32 ビット）浮動小数点数を書き込みます。

パラメータ

バイトストリームに 32 ビット符号付き整数を書き込みます。

パラメータ

指定した文字セットを使用して、バイトストリームにマルチバイトストリングを書き込みます。

パラメータ

バイト配列に AMF 直列化形式でオブジェクトを書き込みます。

パラメータ

関連項目

バイトストリームに 16 ビット整数を書き込みます。パラメータの下位 16 ビットが使用されます。上位 16 ビットは無視されます。

パラメータ

バイトストリームに 32 ビット符号なし整数を書き込みます。

パラメータ

バイトストリームに UTF-8 ストリングを書き込みます。最初に UTF-8 ストリングの長さがバイト単位で 16 ビット整数として書き込まれ、その後にストリングの文字を表すバイトが続きます。

パラメータ

バイトストリームに UTF-8 ストリングを書き込みます。writeUTF() メソッドと似ていますが、writeUTFBytes() では、ストリングに 16 ビット長の接頭辞が付きません。

パラメータ

1. 新しい ByteArray オブジェクトインスタンス byteArr を宣言します。
2. バイトと等価のブール値 false を書き込み、長さをチェックしてその値を戻します。
3. pi の数値と等価の倍精度の浮動小数を書き込みます。
4. バイト配列に書き込まれた 9 バイトを 1 つずつ読み出します。

注意：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.
            }
        }
    }
}