| window.runtime プロパティ | window.runtime.flash.utils.ByteArray |
| 継承 | ByteArray Object |
| ランタイムバージョン: | 1.0, |
注意:ByteArray クラスは、バイトレベルでデータにアクセスする必要がある上級の開発者を対象としています。
メモリ内データはバイトの詰め込み配列(最もコンパクトなデータ型の表現)ですが、ByteArray クラスのインスタンスは標準 [](配列アクセス)演算子を使用して操作できます。また、URLStream および Socket クラスと同じメソッドを使用し、メモリ内ファイルとして読み取りおよび書き込みを行うことができます。
さらに、AMF(Action Message Format)オブジェクトの直列化に加えて、zlib 圧縮および解凍もサポートされています。
ByteArray クラスを使用すると、以下の操作が可能です。
- カスタム プロトコルを作成してサーバーに接続
- 独自の URLEncoder および URLDecoder の作成
- データ型を使用したデータのサイズの最適化
- Adobe® AIR® 内のファイルからロードされたバイナリデータの操作
さらに例を参照
関連する API エレメント
| プロパティ | 定義元 | ||
|---|---|---|---|
| bytesAvailable : uint [読み取り専用]
バイト配列の現在の位置から最後までの読み取り可能なデータのバイト数です。 | ByteArray | ||
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| defaultObjectEncoding : uint [静的]
新しい ByteArray インスタンスに使用する ByteArray クラス用のデフォルトオブジェクトのエンコードを表します。 | ByteArray | ||
| endian : String
データのバイト順序(Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN)を変更するか、読み取ります。 | ByteArray | ||
| length : uint
ByteArray オブジェクトのバイト単位の長さです。 | ByteArray | ||
| objectEncoding : uint
ByteArray インスタンスへの書き込み、または ByteArray インスタンスからの読み取り時の、ActionScript 3.0、ActionScript 2.0、または ActionScript 1.0 の形式を使用する必要があるかどうかの特定に使用されます。 | ByteArray | ||
| position : uint
ByteArray オブジェクト内でのファイルポインターの現在の位置をバイト単位で移動するか、または現在の位置をバイト単位で返します。 | ByteArray | ||
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
| メソッド | 定義元 | ||
|---|---|---|---|
バイトの詰め込み配列を表す ByteArray インスタンスを作成します。これにより、このクラスのメソッドおよびプロパティを使用して、データストレージおよびデータストリームを最適化できます。 | ByteArray | ||
バイトの詰め込み配列を表す ByteArray インスタンスを作成します。これにより、このクラスのメソッドおよびプロパティを使用して、データストレージおよびデータストリームを最適化できます。 | ByteArray | ||
clear():void
バイト配列の内容を消去し、長さと位置のプロパティを 0 にリセットします。 | ByteArray | ||
clear():void
バイト配列の内容を消去し、長さと位置のプロパティを 0 にリセットします。 | ByteArray | ||
compress(algorithm:String):void
バイト配列を圧縮します。 | ByteArray | ||
compress(algorithm:String):void
バイト配列を圧縮します。 | ByteArray | ||
deflate():void
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。 | ByteArray | ||
deflate():void
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。 | ByteArray | ||
![]() | hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
inflate():void
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。 | ByteArray | ||
inflate():void
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。 | ByteArray | ||
![]() | isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() | propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
readBoolean():Boolean
バイトストリームからブール値を読み取ります。 | ByteArray | ||
readBoolean():Boolean
バイトストリームからブール値を読み取ります。 | ByteArray | ||
readByte():int
バイトストリームから符号付きバイトを読み取ります。 | ByteArray | ||
readByte():int
バイトストリームから符号付きバイトを読み取ります。 | ByteArray | ||
バイトストリームから、length パラメーターで指定したデータバイト数を読み取ります。 | ByteArray | ||
バイトストリームから、length パラメーターで指定したデータバイト数を読み取ります。 | ByteArray | ||
readDouble():Number
バイトストリームから IEEE 754 倍精度(64 ビット)浮動小数点数を読み取ります。 | ByteArray | ||
readDouble():Number
バイトストリームから IEEE 754 倍精度(64 ビット)浮動小数点数を読み取ります。 | ByteArray | ||
readFloat():Number
バイトストリームから IEEE 754 単精度(32 ビット)浮動小数点数を読み取ります。 | ByteArray | ||
readFloat():Number
バイトストリームから IEEE 754 単精度(32 ビット)浮動小数点数を読み取ります。 | ByteArray | ||
readInt():int
バイトストリームから符号付き 32 ビット整数を読み取ります。 | ByteArray | ||
readInt():int
バイトストリームから符号付き 32 ビット整数を読み取ります。 | ByteArray | ||
readMultiByte(length:uint, charSet:String):String
指定した文字セットを使用して、バイトストリームから指定した長さのマルチバイトストリングを読み取ります。 | ByteArray | ||
readMultiByte(length:uint, charSet:String):String
指定した文字セットを使用して、バイトストリームから指定した長さのマルチバイトストリングを読み取ります。 | ByteArray | ||
readObject():*
バイト配列から AMF 直列化形式でエンコードされたオブジェクトを読み取ります。 | ByteArray | ||
readObject():*
バイト配列から AMF 直列化形式でエンコードされたオブジェクトを読み取ります。 | ByteArray | ||
readShort():int
バイトストリームから符号付き 16 ビット整数を読み取ります。 | ByteArray | ||
readShort():int
バイトストリームから符号付き 16 ビット整数を読み取ります。 | ByteArray | ||
readUnsignedByte():uint
バイトストリームから符号なしバイトを読み取ります。 | ByteArray | ||
readUnsignedByte():uint
バイトストリームから符号なしバイトを読み取ります。 | ByteArray | ||
readUnsignedInt():uint
バイトストリームから符号なし 32 ビット整数を読み取ります。 | ByteArray | ||
readUnsignedInt():uint
バイトストリームから符号なし 32 ビット整数を読み取ります。 | ByteArray | ||
readUnsignedShort():uint
バイトストリームから符号なし 16 ビット整数を読み取ります。 | ByteArray | ||
readUnsignedShort():uint
バイトストリームから符号なし 16 ビット整数を読み取ります。 | ByteArray | ||
readUTF():String
バイトストリームから UTF-8 ストリングを読み取ります。 | ByteArray | ||
readUTF():String
バイトストリームから UTF-8 ストリングを読み取ります。 | ByteArray | ||
readUTFBytes(length:uint):String
バイトストリームまたはバイト配列から、length パラメーターで指定した UTF-8 バイトのシーケンスを読み取り、ストリングを返します。 | ByteArray | ||
readUTFBytes(length:uint):String
バイトストリームまたはバイト配列から、length パラメーターで指定した UTF-8 バイトのシーケンスを読み取り、ストリングを返します。 | ByteArray | ||
![]() | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
toJSON(k:String):*
ByteArray オブジェクトの値の JSON エンコーディングをカスタマイズするためのオーバーライド可能なメソッドです。 | ByteArray | ||
![]() | toLocaleString():String
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
toString():String
バイト配列をストリングに変換します。 | ByteArray | ||
toString():String
バイト配列をストリングに変換します。 | ByteArray | ||
uncompress(algorithm:String):void
バイト配列を解凍します。 | ByteArray | ||
uncompress(algorithm:String):void
バイト配列を解凍します。 | ByteArray | ||
![]() | valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
writeBoolean(value:Boolean):void
ブール値を書き込みます。 | ByteArray | ||
writeBoolean(value:Boolean):void
ブール値を書き込みます。 | ByteArray | ||
writeByte(value:int):void
バイトストリームにバイトを書き込みます。 | ByteArray | ||
writeByte(value:int):void
バイトストリームにバイトを書き込みます。 | ByteArray | ||
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
指定したバイト配列の offset(0 から始まるインデックス値)バイトから開始される length バイトのシーケンス bytes をバイトストリームに書き込みます。 | ByteArray | ||
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
指定したバイト配列の offset(0 から始まるインデックス値)バイトから開始される length バイトのシーケンス bytes をバイトストリームに書き込みます。 | ByteArray | ||
writeDouble(value:Number):void
バイトストリームに IEEE 754 倍精度(64 ビット)浮動小数点数を書き込みます。 | ByteArray | ||
writeDouble(value:Number):void
バイトストリームに IEEE 754 倍精度(64 ビット)浮動小数点数を書き込みます。 | ByteArray | ||
writeFloat(value:Number):void
バイトストリームに IEEE 754 単精度(32 ビット)浮動小数点数を書き込みます。 | ByteArray | ||
writeFloat(value:Number):void
バイトストリームに IEEE 754 単精度(32 ビット)浮動小数点数を書き込みます。 | ByteArray | ||
writeInt(value:int):void
バイトストリームに 32 ビット符号付き整数を書き込みます。 | ByteArray | ||
writeInt(value:int):void
バイトストリームに 32 ビット符号付き整数を書き込みます。 | ByteArray | ||
writeMultiByte(value:String, charSet:String):void
指定した文字セットを使用して、バイトストリームにマルチバイトストリングを書き込みます。 | ByteArray | ||
writeMultiByte(value:String, charSet:String):void
指定した文字セットを使用して、バイトストリームにマルチバイトストリングを書き込みます。 | ByteArray | ||
writeObject(object:*):void
バイト配列に AMF 直列化形式でオブジェクトを書き込みます。 | ByteArray | ||
writeObject(object:*):void
バイト配列に AMF 直列化形式でオブジェクトを書き込みます。 | ByteArray | ||
writeShort(value:int):void
バイトストリームに 16 ビット整数を書き込みます。 | ByteArray | ||
writeShort(value:int):void
バイトストリームに 16 ビット整数を書き込みます。 | ByteArray | ||
writeUnsignedInt(value:uint):void
バイトストリームに 32 ビット符号なし整数を書き込みます。 | ByteArray | ||
writeUnsignedInt(value:uint):void
バイトストリームに 32 ビット符号なし整数を書き込みます。 | ByteArray | ||
writeUTF(value:String):void
バイトストリームに UTF-8 ストリングを書き込みます。 | ByteArray | ||
writeUTF(value:String):void
バイトストリームに UTF-8 ストリングを書き込みます。 | ByteArray | ||
writeUTFBytes(value:String):void
バイトストリームに UTF-8 ストリングを書き込みます。 | ByteArray | ||
writeUTFBytes(value:String):void
バイトストリームに UTF-8 ストリングを書き込みます。 | ByteArray | ||
bytesAvailable | プロパティ |
bytesAvailable:uint [読み取り専用] | ランタイムバージョン: | 1.0, |
バイト配列の現在の位置から最後までの読み取り可能なデータのバイト数です。
ByteArray オブジェクトにアクセスするたびに bytesAvailable プロパティと読み取りメソッドを組み合わせて使用すれば、有効なデータを確実に読み取ることができます。
defaultObjectEncoding | プロパティ |
public static var defaultObjectEncoding:uint| ランタイムバージョン: | 1.0, |
新しい ByteArray インスタンスに使用する ByteArray クラス用のデフォルトオブジェクトのエンコードを表します。新しい ByteArray インスタンスを作成すると、そのインスタンスのエンコードが defaultObjectEncoding の値で開始します。defaultObjectEncoding プロパティは ObjectEncoding.AMF3 に初期化されます。
バイナリデータからオブジェクトの書き込みまたは読み取りをすると、objectEncoding 値を使用して、ActionScript 3.0、ActionScript 2.0、または ActionScript 1.0 の形式を使用する必要があるかどうかが特定されます。この値は、ObjectEncoding クラスの定数です。
関連する API エレメント
endian | プロパティ |
public var endian:String| ランタイムバージョン: | 1.0, |
データのバイト順序(Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN)を変更するか、読み取ります。
関連する API エレメント
length | プロパティ |
public var length:uint| ランタイムバージョン: | 1.0, |
ByteArray オブジェクトのバイト単位の長さです。
この長さに現在の長さよりも大きい値を設定すると、バイト配列の右側には 0 が詰められます。
この長さに現在の長さよりも小さい値を設定すると、バイト配列は切り詰められます。
objectEncoding | プロパティ |
public var objectEncoding:uint| ランタイムバージョン: | 1.0, |
ByteArray インスタンスへの書き込み、または ByteArray インスタンスからの読み取り時の、ActionScript 3.0、ActionScript 2.0、または ActionScript 1.0 の形式を使用する必要があるかどうかの特定に使用されます。この値は、ObjectEncoding クラスの定数です。
関連する API エレメント
position | プロパティ |
public var position:uint| ランタイムバージョン: | 1.0, |
ByteArray オブジェクト内でのファイルポインターの現在の位置をバイト単位で移動するか、または現在の位置をバイト単位で返します。これは、次に読み取りメソッドまたは書き込みメソッドを呼び出したときに読み取りまたは書き込みが開始されるポイントです。
ByteArray | () | コンストラクター |
public function ByteArray()| ランタイムバージョン: | 1.0, |
バイトの詰め込み配列を表す ByteArray インスタンスを作成します。これにより、このクラスのメソッドおよびプロパティを使用して、データストレージおよびデータストリームを最適化できます。
ByteArray | () | コンストラクター |
public function ByteArray()| ランタイムバージョン: | 1.0, |
バイトの詰め込み配列を表す ByteArray インスタンスを作成します。これにより、このクラスのメソッドおよびプロパティを使用して、データストレージおよびデータストリームを最適化できます。
clear | () | メソッド |
public function clear():void| ランタイムバージョン: | 1.5 |
バイト配列の内容を消去し、長さと位置のプロパティを 0 にリセットします。このメソッドを明示的に呼び出すと、ByteArray インスタンスによって使用されるメモリを解放します。
clear | () | メソッド |
public function clear():void| ランタイムバージョン: | 1.5 |
バイト配列の内容を消去し、長さと位置のプロパティを 0 にリセットします。このメソッドを明示的に呼び出すと、ByteArray インスタンスによって使用されるメモリを解放します。
compress | () | メソッド |
public function compress(algorithm:String):void| ランタイムバージョン: | 1.0, |
バイト配列を圧縮します。バイト配列全体が圧縮されます。Adobe AIR で実行しているコンテンツの場合、CompressionAlgorithm クラスに定義されている値を algorithm パラメーターとして渡すことにより、圧縮アルゴリズムを指定できます。
呼び出し後、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(air.CompressionAlgorithm.DEFLATE) を呼び出した結果と同じです。ただし、compress(air.CompressionAlgorithm.ZLIB) からの結果には余分なメタデータが含まれており、compress(air.CompressionAlgorithm.DEFLATE) の結果には元の ByteArray データの圧縮されたバージョンのみが含まれ、それ以外には何も含まれません。
したがって、deflate 形式を使用して ByteArray インスタンスのデータを gzip や zip などの特定の形式に圧縮する場合は、単に compress(air.CompressionAlgorithm.DEFLATE) を呼び出すだけでは目的を達することはできません。圧縮形式の仕様に従い、適切なメタデータと deflate 形式で圧縮されたデータで構成された ByteArray を作成する必要があります。同様に、gzip や zip などの形式で圧縮されたデータを解凍する場合、単にそのデータに対して uncompress(air.CompressionAlgorithm.DEFLATE) を呼び出すだけでは不十分です。まず、圧縮データからメタデータを分離してから、deflate 形式を使用して圧縮データを解凍する必要があります。
パラメーター
algorithm:String (default = NaN) — 圧縮時に使用する圧縮アルゴリズムです。有効な値は、CompressionAlgorithm クラスに定数で定義されています。デフォルトでは zlib 形式が使用されます。compress(air.CompressionAlgorithm.DEFLATE) の呼び出しには、deflate() メソッドの呼び出しと同じ効果があります。
|
関連する API エレメント
compress | () | メソッド |
public function compress(algorithm:String):void| ランタイムバージョン: | 1.0, |
バイト配列を圧縮します。バイト配列全体が圧縮されます。Adobe AIR で実行しているコンテンツの場合、CompressionAlgorithm クラスに定義されている値を algorithm パラメーターとして渡すことにより、圧縮アルゴリズムを指定できます。
呼び出し後、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(air.CompressionAlgorithm.DEFLATE) を呼び出した結果と同じです。ただし、compress(air.CompressionAlgorithm.ZLIB) からの結果には余分なメタデータが含まれており、compress(air.CompressionAlgorithm.DEFLATE) の結果には元の ByteArray データの圧縮されたバージョンのみが含まれ、それ以外には何も含まれません。
したがって、deflate 形式を使用して ByteArray インスタンスのデータを gzip や zip などの特定の形式に圧縮する場合は、単に compress(air.CompressionAlgorithm.DEFLATE) を呼び出すだけでは目的を達することはできません。圧縮形式の仕様に従い、適切なメタデータと deflate 形式で圧縮されたデータで構成された ByteArray を作成する必要があります。同様に、gzip や zip などの形式で圧縮されたデータを解凍する場合、単にそのデータに対して uncompress(air.CompressionAlgorithm.DEFLATE) を呼び出すだけでは不十分です。まず、圧縮データからメタデータを分離してから、deflate 形式を使用して圧縮データを解凍する必要があります。
パラメーター
algorithm:String (default = NaN) — 圧縮時に使用する圧縮アルゴリズムです。有効な値は、CompressionAlgorithm クラスに定数で定義されています。デフォルトでは zlib 形式が使用されます。compress(air.CompressionAlgorithm.DEFLATE) の呼び出しには、deflate() メソッドの呼び出しと同じ効果があります。
|
関連する API エレメント
deflate | () | メソッド |
public function deflate():void| ランタイムバージョン: | 1.5 |
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。バイト配列全体が圧縮されます。
呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティがバイト配列の末尾に設定されます。
deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。
deflate 形式を使用して ByteArray インスタンスのデータを gzip や zip などの特定の形式に圧縮する場合は、単に deflate() を呼び出すだけでは目的を達することはできません。圧縮形式の仕様に従い、適切なメタデータと deflate 形式で圧縮されたデータで構成された ByteArray を作成する必要があります。同様に、gzip や zip などの形式で圧縮されたデータを解凍する場合、単にそのデータに対して inflate() を呼び出すだけでは不十分です。まず、圧縮データからメタデータを分離してから、deflate 形式を使用して圧縮データを解凍する必要があります。
関連する API エレメント
deflate | () | メソッド |
public function deflate():void| ランタイムバージョン: | 1.5 |
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。バイト配列全体が圧縮されます。
呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティがバイト配列の末尾に設定されます。
deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。
deflate 形式を使用して ByteArray インスタンスのデータを gzip や zip などの特定の形式に圧縮する場合は、単に deflate() を呼び出すだけでは目的を達することはできません。圧縮形式の仕様に従い、適切なメタデータと deflate 形式で圧縮されたデータで構成された ByteArray を作成する必要があります。同様に、gzip や zip などの形式で圧縮されたデータを解凍する場合、単にそのデータに対して inflate() を呼び出すだけでは不十分です。まず、圧縮データからメタデータを分離してから、deflate 形式を使用して圧縮データを解凍する必要があります。
関連する API エレメント
inflate | () | メソッド |
public function inflate():void| ランタイムバージョン: | 1.0, |
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。同じアルゴリズムを使用してバイト配列が圧縮されている必要があります。
呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティが 0 に設定されます。
deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。
deflate 圧縮アルゴリズムを使用する形式で圧縮されたデータ(gzip 形式や zip 形式のデータ)を解凍する場合、圧縮形式データを含む ByteArray に対して単に inflate() を呼び出してもデータは解凍されません。まず、圧縮データ形式の構成要素であるメタデータを実際の圧縮データから分離する必要があります。詳細については、compress() メソッドの説明を参照してください。
例外
IOError — データが有効な圧縮データではありません。指定された圧縮アルゴリズムと同じアルゴリズムを使用して圧縮されていません。
|
関連する API エレメント
inflate | () | メソッド |
public function inflate():void| ランタイムバージョン: | 1.0, |
deflate 圧縮アルゴリズムを使用してバイト配列を圧縮します。同じアルゴリズムを使用してバイト配列が圧縮されている必要があります。
呼び出し後、ByteArray の length プロパティが新しい長さに設定されます。position プロパティが 0 に設定されます。
deflate 圧縮アルゴリズムについては、http://www.ietf.org/rfc/rfc1951.txt の説明を参照してください。
deflate 圧縮アルゴリズムを使用する形式で圧縮されたデータ(gzip 形式や zip 形式のデータ)を解凍する場合、圧縮形式データを含む ByteArray に対して単に inflate() を呼び出してもデータは解凍されません。まず、圧縮データ形式の構成要素であるメタデータを実際の圧縮データから分離する必要があります。詳細については、compress() メソッドの説明を参照してください。
例外
IOError — データが有効な圧縮データではありません。指定された圧縮アルゴリズムと同じアルゴリズムを使用して圧縮されていません。
|
関連する API エレメント
readBoolean | () | メソッド |
public function readBoolean():Boolean| ランタイムバージョン: | 1.0, |
バイトストリームからブール値を読み取ります。1 バイトが読み取られ、バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。
Boolean — バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readBoolean | () | メソッド |
public function readBoolean():Boolean| ランタイムバージョン: | 1.0, |
バイトストリームからブール値を読み取ります。1 バイトが読み取られ、バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。
Boolean — バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readByte | () | メソッド |
public function readByte():int| ランタイムバージョン: | 1.0, |
バイトストリームから符号付きバイトを読み取ります。
戻り値は -128 ~ 127 の範囲です。
戻り値int — -128 ~ 127 の整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readByte | () | メソッド |
public function readByte():int| ランタイムバージョン: | 1.0, |
バイトストリームから符号付きバイトを読み取ります。
戻り値は -128 ~ 127 の範囲です。
戻り値int — -128 ~ 127 の整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readBytes | () | メソッド |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| ランタイムバージョン: | 1.0, |
バイトストリームから、length パラメーターで指定したデータバイト数を読み取ります。バイトは、bytes パラメーターによって指定された ByteArray オブジェクトに読み取られ、offset によって指定された位置から始まるターゲット ByteArray に書き込まれます。
パラメーター
bytes:ByteArray — データの読み込み先の ByteArray オブジェクトです。
| |
offset:uint (default = 0) — 読み取ったデータが書き込まれる bytes 内のオフセット(位置)です。
| |
length:uint (default = 0) — 読み取るバイト数です。デフォルト値の 0 に設定すると、すべてのデータが読み取られます。
|
例外
EOFError — 読み取り可能なデータが不足しています。
| |
RangeError — 入力されたオフセットと長さの値を結合すると、単位の最大値よりも大きくなります。
|
さらに例を参照
readBytes | () | メソッド |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| ランタイムバージョン: | 1.0, |
バイトストリームから、length パラメーターで指定したデータバイト数を読み取ります。バイトは、bytes パラメーターによって指定された ByteArray オブジェクトに読み取られ、offset によって指定された位置から始まるターゲット ByteArray に書き込まれます。
パラメーター
bytes:ByteArray — データの読み込み先の ByteArray オブジェクトです。
| |
offset:uint (default = 0) — 読み取ったデータが書き込まれる bytes 内のオフセット(位置)です。
| |
length:uint (default = 0) — 読み取るバイト数です。デフォルト値の 0 に設定すると、すべてのデータが読み取られます。
|
例外
EOFError — 読み取り可能なデータが不足しています。
| |
RangeError — 入力されたオフセットと長さの値を結合すると、単位の最大値よりも大きくなります。
|
さらに例を参照
readDouble | () | メソッド |
public function readDouble():Number| ランタイムバージョン: | 1.0, |
バイトストリームから IEEE 754 倍精度(64 ビット)浮動小数点数を読み取ります。
戻り値Number — 倍精度(64 ビット)浮動小数点数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readDouble | () | メソッド |
public function readDouble():Number| ランタイムバージョン: | 1.0, |
バイトストリームから IEEE 754 倍精度(64 ビット)浮動小数点数を読み取ります。
戻り値Number — 倍精度(64 ビット)浮動小数点数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readFloat | () | メソッド |
public function readFloat():Number| ランタイムバージョン: | 1.0, |
バイトストリームから IEEE 754 単精度(32 ビット)浮動小数点数を読み取ります。
戻り値Number — 単精度(32 ビット)浮動小数点数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readFloat | () | メソッド |
public function readFloat():Number| ランタイムバージョン: | 1.0, |
バイトストリームから IEEE 754 単精度(32 ビット)浮動小数点数を読み取ります。
戻り値Number — 単精度(32 ビット)浮動小数点数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readInt | () | メソッド |
public function readInt():int| ランタイムバージョン: | 1.0, |
バイトストリームから符号付き 32 ビット整数を読み取ります。
戻り値は -2147483648 ~ 2147483647 の範囲です。
戻り値int — -2147483648 ~ 2147483647 の 32 ビット符号付き整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readInt | () | メソッド |
public function readInt():int| ランタイムバージョン: | 1.0, |
バイトストリームから符号付き 32 ビット整数を読み取ります。
戻り値は -2147483648 ~ 2147483647 の範囲です。
戻り値int — -2147483648 ~ 2147483647 の 32 ビット符号付き整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readMultiByte | () | メソッド |
public function readMultiByte(length:uint, charSet:String):String| ランタイムバージョン: | 1.0, |
指定した文字セットを使用して、バイトストリームから指定した長さのマルチバイトストリングを読み取ります。
パラメーター
length:uint — バイトストリームから読み取るバイト数です。
| |
charSet:String — バイトの解釈に使用する文字セットを表すストリングです。文字セットのストリングには、"shift-jis"、"cn-gb"、および "iso-8859-1" などがあります。完全な一覧については、「サポートされている文字セット」を参照してください。
注意: |
String — UTF-8 エンコードされたストリングです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readMultiByte | () | メソッド |
public function readMultiByte(length:uint, charSet:String):String| ランタイムバージョン: | 1.0, |
指定した文字セットを使用して、バイトストリームから指定した長さのマルチバイトストリングを読み取ります。
パラメーター
length:uint — バイトストリームから読み取るバイト数です。
| |
charSet:String — バイトの解釈に使用する文字セットを表すストリングです。文字セットのストリングには、"shift-jis"、"cn-gb"、および "iso-8859-1" などがあります。完全な一覧については、「サポートされている文字セット」を参照してください。
注意: |
String — UTF-8 エンコードされたストリングです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readObject | () | メソッド |
public function readObject():*| ランタイムバージョン: | 1.0, |
バイト配列から AMF 直列化形式でエンコードされたオブジェクトを読み取ります。
戻り値* — 非直列化されたオブジェクトです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readObject | () | メソッド |
public function readObject():*| ランタイムバージョン: | 1.0, |
バイト配列から AMF 直列化形式でエンコードされたオブジェクトを読み取ります。
戻り値* — 非直列化されたオブジェクトです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readShort | () | メソッド |
public function readShort():int| ランタイムバージョン: | 1.0, |
バイトストリームから符号付き 16 ビット整数を読み取ります。
戻り値は -32768 ~ 32767 の範囲です。
戻り値int — -32768 ~ 32767 の 16 ビット符号付き整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readShort | () | メソッド |
public function readShort():int| ランタイムバージョン: | 1.0, |
バイトストリームから符号付き 16 ビット整数を読み取ります。
戻り値は -32768 ~ 32767 の範囲です。
戻り値int — -32768 ~ 32767 の 16 ビット符号付き整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUnsignedByte | () | メソッド |
public function readUnsignedByte():uint| ランタイムバージョン: | 1.0, |
バイトストリームから符号なしバイトを読み取ります。
戻り値は 0 ~ 255 の範囲です。
戻り値uint — 0 ~ 255 の 32 ビット符号なし整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUnsignedByte | () | メソッド |
public function readUnsignedByte():uint| ランタイムバージョン: | 1.0, |
バイトストリームから符号なしバイトを読み取ります。
戻り値は 0 ~ 255 の範囲です。
戻り値uint — 0 ~ 255 の 32 ビット符号なし整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUnsignedInt | () | メソッド |
public function readUnsignedInt():uint| ランタイムバージョン: | 1.0, |
バイトストリームから符号なし 32 ビット整数を読み取ります。
戻り値は 0 ~ 4294967295 の範囲です。
戻り値uint — 0 ~ 4294967295 の 32 ビット符号なし整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUnsignedInt | () | メソッド |
public function readUnsignedInt():uint| ランタイムバージョン: | 1.0, |
バイトストリームから符号なし 32 ビット整数を読み取ります。
戻り値は 0 ~ 4294967295 の範囲です。
戻り値uint — 0 ~ 4294967295 の 32 ビット符号なし整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUnsignedShort | () | メソッド |
public function readUnsignedShort():uint| ランタイムバージョン: | 1.0, |
バイトストリームから符号なし 16 ビット整数を読み取ります。
戻り値は 0 ~ 65535 の範囲です。
戻り値uint — 0 ~ 65535 の 16 ビット符号なし整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUnsignedShort | () | メソッド |
public function readUnsignedShort():uint| ランタイムバージョン: | 1.0, |
バイトストリームから符号なし 16 ビット整数を読み取ります。
戻り値は 0 ~ 65535 の範囲です。
戻り値uint — 0 ~ 65535 の 16 ビット符号なし整数です。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUTF | () | メソッド |
public function readUTF():String| ランタイムバージョン: | 1.0, |
バイトストリームから UTF-8 ストリングを読み取ります。このストリングには、バイト単位の長さを示す符号なし short が前に付いているものと見なされます。
戻り値String — UTF-8 エンコードされたストリングです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUTF | () | メソッド |
public function readUTF():String| ランタイムバージョン: | 1.0, |
バイトストリームから UTF-8 ストリングを読み取ります。このストリングには、バイト単位の長さを示す符号なし short が前に付いているものと見なされます。
戻り値String — UTF-8 エンコードされたストリングです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUTFBytes | () | メソッド |
public function readUTFBytes(length:uint):String| ランタイムバージョン: | 1.0, |
バイトストリームまたはバイト配列から、length パラメーターで指定した UTF-8 バイトのシーケンスを読み取り、ストリングを返します。
パラメーター
length:uint — UTF-8 バイトの長さを示す符号なし short です。
|
String — 指定した長さの UTF-8 バイトで構成するストリングです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
readUTFBytes | () | メソッド |
public function readUTFBytes(length:uint):String| ランタイムバージョン: | 1.0, |
バイトストリームまたはバイト配列から、length パラメーターで指定した UTF-8 バイトのシーケンスを読み取り、ストリングを返します。
パラメーター
length:uint — UTF-8 バイトの長さを示す符号なし short です。
|
String — 指定した長さの UTF-8 バイトで構成するストリングです。
|
例外
EOFError — 読み取り可能なデータが不足しています。
|
toJSON | () | メソッド |
public function toJSON(k:String):*| ランタイムバージョン: | 3 |
ByteArray オブジェクトの値の JSON エンコーディングをカスタマイズするためのオーバーライド可能なメソッドです。
JSON.stringify() メソッドは、スキャンする各オブジェクトの toJSON() メソッドを検索します。toJSON() が見つかれば、JSON.stringify() で検出された値ごとに toJSON() メソッドが呼び出され、値のペアとなっているキーが渡されます。
ByteArray には、単純にクラス名を返すデフォルトの toJSON() 実装が含まれています。ByteArray では内容を解釈する必要があるので、ByteArray オブジェクトを JSON に書き出す場合は、独自の実装を行う必要があります。このためには、クラスのプロトタイプの toJSON() メソッドを再定義します。
toJSON() メソッドは、あらゆるタイプの値を返すことができます。オブジェクトを返す場合は、stringify() でそのオブジェクトが再帰的に処理されます。toJSON() が文字列を返す場合は、stringify() で再帰的な処理は行われず、オブジェクトをスキャンする処理が続行されます。
パラメーター
k:String — JSON.stringify() がこのオブジェクトをスキャンして検出されたキーと値のペアのキーです。
|
* — クラス名の文字列です。
|
toString | () | メソッド |
public function toString():String| ランタイムバージョン: | 1.0, |
バイト配列をストリングに変換します。配列のデータが Unicode バイト順マークで開始する場合、アプリケーションではストリングの変換時に、そのマークが使用されます。System.useCodePage を true に設定すると、アプリケーションでは、変換時の配列のデータは現在のシステムコードページにあると見なされます。
String — バイト配列のストリング表現です。
|
toString | () | メソッド |
public function toString():String| ランタイムバージョン: | 1.0, |
バイト配列をストリングに変換します。配列のデータが Unicode バイト順マークで開始する場合、アプリケーションではストリングの変換時に、そのマークが使用されます。System.useCodePage を true に設定すると、アプリケーションでは、変換時の配列のデータは現在のシステムコードページにあると見なされます。
String — バイト配列のストリング表現です。
|
uncompress | () | メソッド |
public function uncompress(algorithm:String):void| ランタイムバージョン: | 1.0, |
バイト配列を解凍します。Adobe AIR で実行しているコンテンツの場合、CompressionAlgorithm クラスに定義されている値を algorithm パラメーターとして渡すことにより、圧縮アルゴリズムを指定できます。 同じアルゴリズムを使用してバイト配列が圧縮されている必要があります。
呼び出し後、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() メソッドの説明を参照してください。
パラメーター
algorithm:String (default = NaN) — 解凍時に使用する圧縮アルゴリズムです。データの圧縮に使用されたものと同じ圧縮アルゴリズムを指定する必要があります。有効な値は、CompressionAlgorithm クラスに定数で定義されています。デフォルトでは zlib 形式が使用されます。このパラメーターは、Adobe AIR で実行しているコンテンツに対してのみ有効です。
|
例外
IOError — データが有効な圧縮データではありません。指定された圧縮アルゴリズムと同じアルゴリズムを使用して圧縮されていません。
|
関連する API エレメント
uncompress | () | メソッド |
public function uncompress(algorithm:String):void| ランタイムバージョン: | 1.0, |
バイト配列を解凍します。Adobe AIR で実行しているコンテンツの場合、CompressionAlgorithm クラスに定義されている値を algorithm パラメーターとして渡すことにより、圧縮アルゴリズムを指定できます。 同じアルゴリズムを使用してバイト配列が圧縮されている必要があります。
呼び出し後、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() メソッドの説明を参照してください。
パラメーター
algorithm:String (default = NaN) — 解凍時に使用する圧縮アルゴリズムです。データの圧縮に使用されたものと同じ圧縮アルゴリズムを指定する必要があります。有効な値は、CompressionAlgorithm クラスに定数で定義されています。デフォルトでは zlib 形式が使用されます。このパラメーターは、Adobe AIR で実行しているコンテンツに対してのみ有効です。
|
例外
IOError — データが有効な圧縮データではありません。指定された圧縮アルゴリズムと同じアルゴリズムを使用して圧縮されていません。
|
関連する API エレメント
writeBoolean | () | メソッド |
public function writeBoolean(value:Boolean):void| ランタイムバージョン: | 1.0, |
ブール値を書き込みます。value パラメーターに従って、1 バイトが書き込まれます。true の場合は 1、false の場合は 0 のいずれかが書き込まれます。
パラメーター
value:Boolean — 書き込むバイトを決定するブール値です。このパラメーターが true の場合は 1、false の場合は 0 がメソッドによって書き込まれます。
|
writeBoolean | () | メソッド |
public function writeBoolean(value:Boolean):void| ランタイムバージョン: | 1.0, |
ブール値を書き込みます。value パラメーターに従って、1 バイトが書き込まれます。true の場合は 1、false の場合は 0 のいずれかが書き込まれます。
パラメーター
value:Boolean — 書き込むバイトを決定するブール値です。このパラメーターが true の場合は 1、false の場合は 0 がメソッドによって書き込まれます。
|
writeByte | () | メソッド |
public function writeByte(value:int):void| ランタイムバージョン: | 1.0, |
バイトストリームにバイトを書き込みます。
パラメーターの下位 8 ビットが使用されます。上位 24 ビットは無視されます。
パラメーター
value:int — 32 ビット整数です。バイトストリームに下位 8 ビットが書き込まれます。
|
writeByte | () | メソッド |
public function writeByte(value:int):void| ランタイムバージョン: | 1.0, |
バイトストリームにバイトを書き込みます。
パラメーターの下位 8 ビットが使用されます。上位 24 ビットは無視されます。
パラメーター
value:int — 32 ビット整数です。バイトストリームに下位 8 ビットが書き込まれます。
|
writeBytes | () | メソッド |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| ランタイムバージョン: | 1.0, |
指定したバイト配列の offset(0 から始まるインデックス値)バイトから開始される length バイトのシーケンス bytes をバイトストリームに書き込みます。
length パラメーターを省略すると、デフォルトの長さの 0 が使用され、メソッドによって offset から開始されるバッファー全体が書き込まれます。 offset パラメーターも省略した場合は、バッファー全体が書き込まれます。
offset または length が範囲外の場合、これらは bytes 配列の最初と最後に固定されます。
パラメーター
bytes:ByteArray — ByteArray オブジェクトです。
| |
offset:uint (default = 0) — 書き込みを開始する配列の位置を示す、0 から始まるインデックスです。
| |
length:uint (default = 0) — 書き込むバッファーの長さを示す符号付きの整数です。
|
さらに例を参照
writeBytes | () | メソッド |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| ランタイムバージョン: | 1.0, |
指定したバイト配列の offset(0 から始まるインデックス値)バイトから開始される length バイトのシーケンス bytes をバイトストリームに書き込みます。
length パラメーターを省略すると、デフォルトの長さの 0 が使用され、メソッドによって offset から開始されるバッファー全体が書き込まれます。 offset パラメーターも省略した場合は、バッファー全体が書き込まれます。
offset または length が範囲外の場合、これらは bytes 配列の最初と最後に固定されます。
パラメーター
bytes:ByteArray — ByteArray オブジェクトです。
| |
offset:uint (default = 0) — 書き込みを開始する配列の位置を示す、0 から始まるインデックスです。
| |
length:uint (default = 0) — 書き込むバッファーの長さを示す符号付きの整数です。
|
さらに例を参照
writeDouble | () | メソッド |
public function writeDouble(value:Number):void| ランタイムバージョン: | 1.0, |
バイトストリームに IEEE 754 倍精度(64 ビット)浮動小数点数を書き込みます。
パラメーター
value:Number — 倍精度(64 ビット)浮動小数点数です。
|
writeDouble | () | メソッド |
public function writeDouble(value:Number):void| ランタイムバージョン: | 1.0, |
バイトストリームに IEEE 754 倍精度(64 ビット)浮動小数点数を書き込みます。
パラメーター
value:Number — 倍精度(64 ビット)浮動小数点数です。
|
writeFloat | () | メソッド |
public function writeFloat(value:Number):void| ランタイムバージョン: | 1.0, |
バイトストリームに IEEE 754 単精度(32 ビット)浮動小数点数を書き込みます。
パラメーター
value:Number — 単精度(32 ビット)浮動小数点数です。
|
writeFloat | () | メソッド |
public function writeFloat(value:Number):void| ランタイムバージョン: | 1.0, |
バイトストリームに IEEE 754 単精度(32 ビット)浮動小数点数を書き込みます。
パラメーター
value:Number — 単精度(32 ビット)浮動小数点数です。
|
writeInt | () | メソッド |
public function writeInt(value:int):void| ランタイムバージョン: | 1.0, |
バイトストリームに 32 ビット符号付き整数を書き込みます。
パラメーター
value:int — バイトストリームに書き込む整数です。
|
writeInt | () | メソッド |
public function writeInt(value:int):void| ランタイムバージョン: | 1.0, |
バイトストリームに 32 ビット符号付き整数を書き込みます。
パラメーター
value:int — バイトストリームに書き込む整数です。
|
writeMultiByte | () | メソッド |
public function writeMultiByte(value:String, charSet:String):void| ランタイムバージョン: | 1.0, |
指定した文字セットを使用して、バイトストリームにマルチバイトストリングを書き込みます。
パラメーター
value:String — 書き込まれるストリング値です。
| |
charSet:String — 使用する文字セットを表すストリングです。文字セットのストリングには、"shift-jis"、"cn-gb"、および "iso-8859-1" などがあります。完全な一覧については、「サポートされている文字セット」を参照してください。
|
writeMultiByte | () | メソッド |
public function writeMultiByte(value:String, charSet:String):void| ランタイムバージョン: | 1.0, |
指定した文字セットを使用して、バイトストリームにマルチバイトストリングを書き込みます。
パラメーター
value:String — 書き込まれるストリング値です。
| |
charSet:String — 使用する文字セットを表すストリングです。文字セットのストリングには、"shift-jis"、"cn-gb"、および "iso-8859-1" などがあります。完全な一覧については、「サポートされている文字セット」を参照してください。
|
writeObject | () | メソッド |
public function writeObject(object:*):void| ランタイムバージョン: | 1.0, |
バイト配列に AMF 直列化形式でオブジェクトを書き込みます。
パラメーター
object:* — 直列化するオブジェクトです。
|
writeObject | () | メソッド |
public function writeObject(object:*):void| ランタイムバージョン: | 1.0, |
バイト配列に AMF 直列化形式でオブジェクトを書き込みます。
パラメーター
object:* — 直列化するオブジェクトです。
|
writeShort | () | メソッド |
public function writeShort(value:int):void| ランタイムバージョン: | 1.0, |
バイトストリームに 16 ビット整数を書き込みます。パラメーターの下位 16 ビットが使用されます。上位 16 ビットは無視されます。
パラメーター
value:int — バイトストリームに下位 16 ビットが書き込まれる 32 ビット整数です。
|
writeShort | () | メソッド |
public function writeShort(value:int):void| ランタイムバージョン: | 1.0, |
バイトストリームに 16 ビット整数を書き込みます。パラメーターの下位 16 ビットが使用されます。上位 16 ビットは無視されます。
パラメーター
value:int — バイトストリームに下位 16 ビットが書き込まれる 32 ビット整数です。
|
writeUnsignedInt | () | メソッド |
public function writeUnsignedInt(value:uint):void| ランタイムバージョン: | 1.0, |
バイトストリームに 32 ビット符号なし整数を書き込みます。
パラメーター
value:uint — バイトストリームに書き込む符号なし整数です。
|
writeUnsignedInt | () | メソッド |
public function writeUnsignedInt(value:uint):void| ランタイムバージョン: | 1.0, |
バイトストリームに 32 ビット符号なし整数を書き込みます。
パラメーター
value:uint — バイトストリームに書き込む符号なし整数です。
|
writeUTF | () | メソッド |
public function writeUTF(value:String):void| ランタイムバージョン: | 1.0, |
バイトストリームに UTF-8 ストリングを書き込みます。最初に UTF-8 ストリングの長さがバイト単位で 16 ビット整数として書き込まれ、その後にストリングの文字を表すバイトが続きます。
パラメーター
value:String — 書き込まれるストリング値です。
|
例外
RangeError — 長さが 65535 よりも大きい場合。
|
writeUTF | () | メソッド |
public function writeUTF(value:String):void| ランタイムバージョン: | 1.0, |
バイトストリームに UTF-8 ストリングを書き込みます。最初に UTF-8 ストリングの長さがバイト単位で 16 ビット整数として書き込まれ、その後にストリングの文字を表すバイトが続きます。
パラメーター
value:String — 書き込まれるストリング値です。
|
例外
RangeError — 長さが 65535 よりも大きい場合。
|
writeUTFBytes | () | メソッド |
public function writeUTFBytes(value:String):void| ランタイムバージョン: | 1.0, |
バイトストリームに UTF-8 ストリングを書き込みます。writeUTF() メソッドと似ていますが、writeUTFBytes() では、ストリングに 16 ビット長の接頭辞が付きません。
パラメーター
value:String — 書き込まれるストリング値です。
|
writeUTFBytes | () | メソッド |
public function writeUTFBytes(value:String):void| ランタイムバージョン: | 1.0, |
バイトストリームに UTF-8 ストリングを書き込みます。writeUTF() メソッドと似ていますが、writeUTFBytes() では、ストリングに 16 ビット長の接頭辞が付きません。
パラメーター
value:String — 書き込まれるストリング値です。
|
- 新しい ByteArray オブジェクトインスタンス
byteArrを宣言します。 - バイトと等価のブール値
falseを書き込み、長さをチェックしてその値を戻します。 - pi の数値と等価の倍精度の浮動小数を書き込みます。
- バイト配列に書き込まれた 9 バイトを 1 つずつ読み出します。
注意:air.trace() がバイトに対して呼び出されると、バイト配列に保存された 10 進表現のバイトが出力されます。
コードセグメントが最後に追加され、ファイルの終端エラーをチェックして、バイトストリームが最後まで読み取られないことを確認します。
<html>
<head>
<script src="AIRAliases.js" />
<script>
function init() {
var byteArr = new air.ByteArray();
byteArr.writeBoolean(false);
air.trace(byteArr.length); // 1
air.trace(byteArr[0]); // 0
byteArr.writeDouble(Math.PI);
air.trace(byteArr.length); // 9
air.trace(byteArr[0]); // 0
air.trace(byteArr[1]); // 64
air.trace(byteArr[2]); // 9
air.trace(byteArr[3]); // 33
air.trace(byteArr[4]); // 251
air.trace(byteArr[5]); // 84
air.trace(byteArr[6]); // 68
air.trace(byteArr[7]); // 45
air.trace(byteArr[8]); // 24
byteArr.position = 0;
try {
air.trace(byteArr.readBoolean() == false); // true
}
catch(e) {
air.trace(e); // EOFError: Error #2030: End of file was encountered.
}
try {
air.trace(byteArr.readDouble()); // 3.141592653589793
}
catch(e) {
trace(e); // EOFError: Error #2030: End of file was encountered.
}
try {
air.trace(byteArr.readDouble());
}
catch(e) {
air.trace(e); // EOFError: Error #2030: End of file was encountered.
}
}
</script>
</head>
<body onload="init()">
</body>
</html>- 新しい ByteArray オブジェクトインスタンス
byteArrを宣言します。 - バイトと等価のブール値
falseを書き込み、長さをチェックしてその値を戻します。 - pi の数値と等価の倍精度の浮動小数を書き込みます。
- バイト配列に書き込まれた 9 バイトを 1 つずつ読み出します。
注意:air.trace() がバイトに対して呼び出されると、バイト配列に保存された 10 進表現のバイトが出力されます。
コードセグメントが最後に追加され、ファイルの終端エラーをチェックして、バイトストリームが最後まで読み取られないことを確認します。
<html>
<head>
<script src="AIRAliases.js" />
<script>
function init() {
var byteArr = new air.ByteArray();
byteArr.writeBoolean(false);
air.trace(byteArr.length); // 1
air.trace(byteArr[0]); // 0
byteArr.writeDouble(Math.PI);
air.trace(byteArr.length); // 9
air.trace(byteArr[0]); // 0
air.trace(byteArr[1]); // 64
air.trace(byteArr[2]); // 9
air.trace(byteArr[3]); // 33
air.trace(byteArr[4]); // 251
air.trace(byteArr[5]); // 84
air.trace(byteArr[6]); // 68
air.trace(byteArr[7]); // 45
air.trace(byteArr[8]); // 24
byteArr.position = 0;
try {
air.trace(byteArr.readBoolean() == false); // true
}
catch(e) {
air.trace(e); // EOFError: Error #2030: End of file was encountered.
}
try {
air.trace(byteArr.readDouble()); // 3.141592653589793
}
catch(e) {
trace(e); // EOFError: Error #2030: End of file was encountered.
}
try {
air.trace(byteArr.readDouble());
}
catch(e) {
air.trace(e); // EOFError: Error #2030: End of file was encountered.
}
}
</script>
</head>
<body onload="init()">
</body>
</html>Tue Oct 25 2011, 05:14 AM -07:00

Object
継承されるパブリックプロパティを隠す
継承プロパティの表示